Google Home Sample App for Matter 使用 Google Home Mobile SDK 创建一个与 Google Home app (GHA)。 此示例应用提供了以下功能：
- 将实体和虚拟 Matter 设备调试到 本地 Android 结构
- 将实体和虚拟设备调试到开发结构脉络
- 在开发结构脉络上控制设备，例如开启 灯具
- 多管理员功能可让您在开发结构脉络上共享设备 反过来也能够将 从其他应用共享的 Fibrid 设备
- 开发者工具
本指南介绍了如何安装 Sample App for Matter APK 以及如何使用 以便调试、控制和共享 Matter 设备。
如需下载源代码，请了解如何集成 Mobile SDK 以及自定义 Android Studio 中的界面，不妨试用我们的 Sample App for Matter Codelab。
<ph type="x-smartling-placeholder"></ph> 前往 Sample App for Matter Codelab
前提条件
- 可测试的 Android O（8.1，API 级别 27）或更高版本的设备。接收者 请确保您的设备装有最新版 Matter 支持，请查看 验证 Matter 个模块和服务 指南。
- 构建一款具有开启/关闭功能的 Matter 设备。这个
示例应用可与虚拟设备和 ESP32 搭配使用。
- Matter Virtual Device (MVD)。 为尽可能减少环境问题，我们强烈建议您使用 MVD 。如果遇到问题 调查是否针对 MVD 使用示例应用。
- 构建 Matter 虚拟设备
rootnode_dimmablelight_bCwGYSDpoe应用当您 创建 Matter 集成 在Google Home Developer Console中， 使用0xFFF1作为供应商 ID，使用0x8000作为产品 ID。 - 构建 Espressif 设备
all-clusters-app当您 创建 Matter 集成 在Developer Console中， 使用0xFFF1作为供应商 ID，使用0x8001作为产品 ID。
无需 hub（例如 Google Nest Hub (2nd gen)）即可进行佣金 并使用 Sample App for Matter 控制设备。
安装
前往“版本”部分 在 Sample App for Matter GitHub 中 存储库如需查看最新版本，请在“资产”部分中找到 名称为
GHSAFM-version-default-debug.apk。请勿选择targetcommissioner。安装 Android 调试桥 (adb)：
<ph type="x-smartling-placeholder"></ph> 安装 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。确定证明 扫描二维码或点按使用配对码。
调试完成后，输入 Device Name，然后点按 Done。
您的设备现已连接到本地 Android 结构和 和开发结构脉络
所有调试工作及相关页面均由 调试设备时，Play services。这个 可提供一致的用户体验，并且无需处理敏感 权限，例如 Wi-Fi 和 Thread 凭据。
控制设备
开发结构脉络会创建凭据来控制 Matter 设备。
在主屏幕上，您可以将设备切换为开启或关闭。点按 设备以访问设备详细信息。
共享设备
共享设备在 Google Play 中称为多管理员流程， Matter 规范。 在对设备进行示例应用调试后，您就可以轻松分享该设备 生态系统。
如需与其他生态系统共享您的 Matter 设备， 则您需要在 Android 设备上安装其他平台这个 外部平台将成为目标调试器。我们又创建了一个 可以用作目标调试器的示例应用的实例。
前往“版本”部分 在 Sample App for Matter GitHub 中 存储库如需查看最新版本，请在“资产”部分中找到 名称为
GHSAFM-version-targetcommissioner-debug.apk。请勿选择default。安装目标调试器。
$ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apk在主屏幕上，点按设备以显示设备信息。轻击 分享。
示例应用调用 Mobile SDK Share API，同样， 控制权已转让给 Play services。
系统会显示分享表单，供您选择想要使用的应用或平台 。此屏幕提供了两种方法供您 设备：
- 通过与目标调试器应用共享的设置代码手动创建
- 使用已注册为 Matter 专员
目标调试器应用带有 GHSAFM-TC 标签。点按这个 示例应用程序来共享您的设备。
接下来，外部应用（目标调试器）完成 添加到自己的结构中。
设置
在主屏幕上，点击“设置” 图标。在这里，您可以选择 更新用户偏好设置、获取帮助以及详细了解该应用。
半页通知
在“设置”屏幕中，您可以选择停用主动式佣金 有 Matter 台设备的发现通知。
如果您的应用提供自己的 Matter 发现或 则可以不显示这些通知，以免出现 广告干扰。请参见禁止在佣金中投放广告 通知 。
开发者工具
在“设置”屏幕中，您还可以访问开发者工具。
查看设备和用户偏好设置 DataStore 仓库的内容 在 Logcat 中完成以下步骤：
点击 Log repositories content。
点击 OK 进入对话框，然后检查 Logcat。
反馈和帮助
提交您的想法或反馈，帮助我们改进开发工作 Sample App for Matter，请填写我们的反馈表单。
<ph type="x-smartling-placeholder"></ph> 向我们发送反馈
如果您在使用Sample App for Matter时遇到问题，请尝试完成 验证环境的步骤：
如果您对使用该示例应用有疑问或发现代码 bug，可以 可以将问题提交到 GitHub 代码库中的问题跟踪器：
如需获得 Google 针对技术问题的官方指导，请使用智能家居 开发者论坛：
如需从社区获取技术支持，请在以下位置使用 google-smart-home 标记：
Stack Overflow：