Google Home Sample App for Matter uses the Google Home Mobile SDK to create an Android app that's similar to Google Home app (GHA) . This sample app provides the following features:
- 佣金（实体和虚拟） Matter devices to the Local Android fabric
- 将实体设备和虚拟设备提交到开发结构
- 控制开发结构上的设备，例如开灯
- 通过多管理员功能，您可以与其他应用共享开发结构上的设备；反过来，您还可以将一些应用加入通过其他应用共享的开发结构中
- 开发者实用程序
本指南介绍了如何安装 Sample App for Matter APK 以及如何使用它来调试、控制和分享 Matter 设备。
如需下载源代码，请了解如何在 Android Studio 中集成 Mobile SDK 并自定义屏幕，请尝试我们的 Sample App for Matter Codelab。
转到 Sample App for Matter Codelab
前提条件
- 可用于测试的 Android O（8.1、API 级别 27）或更高版本的设备。为了确保您的设备获得最新的 Matter 支持，请查看验证 Matter 模块和服务指南。
- 构建具备开启/关闭功能的 Matter 设备。此示例应用可与虚拟设备和 ESP32 搭配使用。
- 使用
rootnode_dimmablelight_bCwGYSDpoe应用构建 Matter 虚拟设备。在 Google Home Developer Console 中创建 Matter 集成时，请使用0xFFF1作为供应商 ID，并将0x8000用作产品 ID。 - 使用
all-clusters-app构建 Espressif 设备。在 Developer Console 中创建 Matter 集成时，请将0xFFF1用作供应商 ID，并将0x8001用作产品 ID。
- 使用
你不需要 hub，例如 Google Nest Hub (2nd gen) , to commission and control devices with the Sample App for Matter.
安装
转到 Sample App for Matter GitHub 代码库中的“版本”部分。找到名为
GHSAFM-1.4.1-default-debug.apk的 APK。请勿选择targetcommissioner：安装 Android 调试桥 (adb)：
使用 USB 连接 Android 设备并启用 File Transfer，然后安装 APK：
$ adb unroot && adb install GHSAFM-1.4.1-default-debug.apk
调试设备
首次启动示例应用时，您会看到一个对话框，其中包含指向 Sample App for Matter Codelab 的链接。如果您选择不再显示此消息，则可以随时更新此对话框，方法是在应用的“管理”部分更新您的偏好设置。
在接下来的步骤中，您将向 Local Android 结构中添加一个 Matter 设备，以及仅在示例应用的本地开发结构。
什么是 Matter 面料？
Fabric 是家庭网络中的设备之间的共享信任域，使它们能够相互通信。
设备可能有一个或多个平台，它们对应一个平台、应用或一组设备，它们可以相互交互。Fabric 具有唯一 ID，并且设备共享同一组凭据和证书授权机构 (CA)。这些凭据在 Matter 调试期间分配。
如需调试 Matter 设备，请完成以下步骤：
点按 Add Device 按钮以启动调试过程。
接下来，控制权将移交给Google Play services , which is launched from a call to the Mobile SDK. To establish proof of possession, Scan QR code or tap Use pairing code.
调试完成后，输入设备名称，然后点按完成。
您的设备现已连接到本地 Android 结构和开发结构。
在调试设备时，所有调试工作和关联的屏幕均由 Play services 处理。这样可以提供一致的用户体验，从而无需处理敏感权限，例如 Wi-Fi 和 Thread 凭据。
控制设备
开发结构会创建凭据，以便直接从示例应用控制 Matter 设备。
在主屏幕上，您可以开启或关闭设备。点按设备即可访问设备详细信息。
共享设备
共享设备在 Matter 规范中称为多管理员流程。 将设备委托给示例应用后，您就可以轻松地与其他生态系统共享该设备。
如需与其他生态系统共享您的 Matter 设备，您需要在 Android 设备上安装其他平台。此外部平台会成为目标调试器。我们创建了一个示例应用的另一个实例，您可以将其用作目标调试器。
转到 Sample App for Matter GitHub 代码库中的“版本”部分。找到名为
GHSAFM-[version]-targetcommissioner的最新 APK，例如GHSAFM-1.4.1-targetcommissioner-debug.apk：安装目标调试器。
$ adb unroot && adb install GHSAFM-1.4.1-targetcommissioner-debug.apk在主屏幕上，点按设备以显示设备信息。点按分享。
示例应用会调用 Mobile SDK Share API，同样会将控制权转移给 Play services。
系统会显示分享表单，供您选择要将设备与之配对的应用或平台。此屏幕为您提供了两种设备共享方式：
- 通过设置代码手动与目标调试器应用共享
- 使用已注册为 Matter 调试器的本地 Android 应用
目标调试器应用带有 GHSAFM-TC 标签。点按示例应用的此实例即可共享您的设备。
接下来，外部应用（目标调试器）将设备调试到自己的结构中。
设置
在主屏幕上，点击设置 图标。在这里，您可以选择更新用户偏好设置、获取帮助和详细了解该应用。
半屏通知
在“Settings”屏幕中，您可以选择为 Matter 设备停用主动式可调试发现通知。
如果您的应用提供自己的 Matter 发现或调试流程，建议您抑制这些通知，以防服务中断。如需了解详情，请参阅禁止发送可调试发现通知。
开发者实用程序
在“设置”屏幕中，您还可以访问开发者实用程序。
如需查看 Logcat 中的设备和用户偏好设置 DataStore 代码库的内容，请完成以下步骤：
点击记录代码库内容。
点击对话框中的确定，然后勾选 Logcat。
反馈和帮助
如需就我们如何使用 Sample App for Matter 改善开发体验提交您的想法或反馈，请填写我们的反馈表单。
如果您在使用 Sample App for Matter 时遇到问题，请尝试完成验证环境的步骤：
如果您对使用示例应用有疑问或发现代码 bug，可以向 GitHub 代码库中的问题跟踪器提交问题：
如需获得 Google 官方技术问题的指导，请使用智能家居开发者论坛：
如需获得社区的技术支持，请使用 Stack Overflow 上的 google-smart-home 标记：