Google Home Sample App for Matter 使用 Google Home Mobile SDK 创建一个类似于 Google Home app (GHA)的 Android 应用。 此示例应用提供以下功能：
- 将实体和虚拟 Matter 设备调试到 本地 Android 结构
- 将实体和虚拟设备调试到开发结构
- 控制开发结构中的设备，例如打开灯
- 借助多管理员功能，您可以与其他应用共享开发结构中的设备，反之亦然，即能够将其他应用共享的设备纳入开发结构中
- 开发者实用程序
本指南介绍了如何安装 Sample App for Matter APK，以及如何使用 它来调试、控制和共享 Matter 设备。
如需下载源代码、了解如何集成 Mobile SDK以及在 Android Studio 中自定义屏幕，请尝试我们的 Sample App for Matter Codelab。
前往 Sample App for Matter Codelab
前提条件
- 可用于测试的 Android O（8.1，API 级别 27）或更新版本的设备。如需确保您的设备支持最新的 Matter ，请查看 验证 Matter 模块和服务 指南。
- 构建具有开/关功能的 Matter 设备。此示例应用适用于虚拟设备和 ESP32。
- Matter 虚拟设备 (MVD)。 为尽量减少环境问题，我们强烈建议您先使用 MVD。如果您遇到任何问题，在针对 MVD 使用示例应用时，调查问题会容易得多。
- 使用
rootnode_dimmablelight_bCwGYSDpoe应用构建 Matter 虚拟设备 。在 Google Home Developer Console 中 创建 Matter 集成 时，请使用0xFFF1作为供应商 ID，并使用0x8000作为产品 ID。 - 构建 Espressif 设备
使用
all-clusters-app。在 Developer Console 中 创建 Matter 集成 时，请使用0xFFF1作为供应商 ID，并使用0x8001作为产品 ID。
您无需 hub（例如 Google Nest Hub (2nd gen)）即可使用 Sample App for Matter 调试 和控制设备。
安装
前往 “版本”部分 GitHub 代码库。Sample App for Matter对于最新版本，请在“资产”部分中找到名为 的 APK
GHSAFM-version-default-debug.apk。请勿选择targetcommissioner。安装 Android 调试桥 (adb)：
使用 USB 连接 Android 设备并启用文件传输，然后 安装 APK：
$ adb unroot && adb install GHSAFM-version-default-debug.apk
调试设备
首次启动示例应用时，您会看到一个对话框，其中包含 指向 Sample App for Matter Codelab 的链接。 如果您选择不再显示此消息，则可以随时在应用的“管理”部分中更新偏好设置，以重新显示该对话框 。
在接下来的步骤中，您将向Matter设备添加到 本地 Android 结构，以及仅对示例 应用本地的开发结构。
什么是 Matter 结构？
Matter 结构是家庭网络中的多个设备 之间建立共享信任域，让这些设备能够相互通信。
设备可能具有一个或多个与平台、应用或一组相互交互的设备对应的结构。结构具有唯一的 ID，设备共享同一组凭据和证书授权机构 (CA )。这些凭据是在 Matter 调试期间分配的。
如需调试 Matter 设备，请完成以下步骤：
点按“添加 设备”按钮以开始调试过程。
接下来，控制权会转移到 Google Play services，该服务是从对 Mobile SDK 的调用启动的。如需建立所有权证明，请扫描二维码 或点按使用配对码 。
调试完成后，输入设备名称，然后点按完成。
您的设备现已连接到本地 Android 结构和开发结构。
调试设备时，所有调试工作和相关屏幕都由 Play services处理。这样可以提供一致的用户体验，并无需处理敏感权限，例如 Wi-Fi 和 Thread 凭据。
控制设备
开发结构会创建凭据，以便直接从示例应用控制 Matter设备。
在主屏幕上，您可以将设备切换为开启 或关闭 。点按设备即可访问设备详细信息。
共享设备
在 Matter规范中，共享设备称为多管理员流。 将设备调试到示例应用后，您可以轻松地与其他生态系统共享该设备。
如需与其他生态系统共享 Matter 设备， 您需要在 Android 设备上安装另一个平台。此外部平台将成为目标调试器 。我们创建了另一个示例应用实例，您可以将其用作目标调试器。
前往 “版本”部分 GitHub 代码库。Sample App for Matter对于最新版本，请在“资产”部分中找到名为 的 APK
GHSAFM-version-targetcommissioner-debug.apk。请勿选择default。安装目标调试器。
$ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apk在主屏幕上，点按设备以显示设备信息。点按共享 。
示例应用会调用 Mobile SDK Share API， 控制权会再次转移到 Play services。
系统会显示一个共享表单，让您可以选择要与设备配对的应用或平台。此屏幕提供了两种共享设备的方式：
- 通过要与目标调试器应用共享的设置代码手动共享
- 与已注册为 Matter 调试器的本地 Android 应用共享
目标调试器应用标记为 GHSAFM-TC 。点按此示例应用实例即可共享设备。
接下来，外部应用（目标调试器）会完成将设备调试到其自身结构中的操作。
设置
在主屏幕上，点击“设置”图标 settings 。在这里，您可以选择更新用户偏好设置、获取帮助以及详细了解该应用。
半屏通知
在“设置”屏幕中，您可以选择停用针对 Matter 设备的主动调试发现通知。
如果您的应用提供自己的 Matter 发现或 调试流程，您可能希望禁止显示这些通知，以防止 中断。如需了解详情，请参阅禁止显示可调试发现 发现通知 。
开发者实用程序
在“设置”屏幕中，您还可以访问开发者实用程序 。
如需在设备和用户偏好设置 DataStore 代码库中查看 Logcat 的内容 ，请完成以下步骤：
点击记录代码库内容 。
点击对话框中的确定 ，然后选中 Logcat 。
反馈和帮助
如需提交您对如何改进开发体验（使用 Sample App for Matter）的想法或反馈，请填写我们的反馈表单。
如果您在使用 Sample App for Matter 时遇到问题，请尝试完成 以下步骤来验证您的环境：
如果您对使用示例应用有疑问或发现代码 bug，可以在 GitHub 代码库的问题跟踪器中提交问题：
如需获取 Google 针对技术问题的官方指导，请使用智能家居开发者论坛：
如需从社区获取技术支持，请在 Stack Overflow 上使用 google-smart-home 标记：