Google Home Sample App for Matter 使用 Google Home Mobile SDK 创建与 Google Home app (GHA) 类似的 Android 应用。该示例应用提供以下功能:
- 将实体和虚拟 Matter 设备调试到本地 Android 结构
- 调试实体和虚拟设备到开发结构
- 控制开发结构上的设备,例如开灯
- 通过多管理功能,您可以与其他应用共享开发结构上的设备;反过来,您还可以将其他应用加入到开发结构的设备中。
- 开发者实用程序
本指南介绍了如何安装 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))来使用 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 的链接。如果您选择不再显示此消息,您可以随时更新对话框,只需在应用的“管理”部分中更新偏好设置即可。
在接下来的步骤中,您将向本地 Android 结构添加 Matter 设备,以及仅在示例应用的本地开发结构。
什么是 Matter 面料?
Matter 结构是家庭网络中的设备之间的共享信任域,使它们能够相互通信。
设备可能有一个或多个结构,这些结构对应于某个平台、应用或设备组进行交互。Fabric 具有唯一 ID,并且设备共享同一组凭据和证书授权机构 (CA)。系统会在 Matter 调试期间分配这些凭据。
如要调试 Matter 设备,请完成以下步骤:
点按
Add Device 按钮即可开始调试流程。接下来,控制权将移交给通过调用 Mobile SDK 启动的 Google Play services。如需建立所有权证明,请扫描二维码或点按使用配对码。
调试完成后,输入设备名称,然后点按完成。
您的设备现已连接到本地 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 标记。点按该示例应用的实例以分享您的设备。
接下来,外部应用(目标调试器)将设备调试完成到自己的结构中。
设置
在主屏幕上,点击设置
图标。在这里,您可以选择更新用户偏好设置、获取帮助和详细了解应用。半页通知
在“设置”屏幕中,您可以选择为 Matter 设备停用主动调试式发现通知。
如果您的应用提供自己的 Matter 发现或调试流程,建议您抑制这些通知,以免服务中断。如需了解详情,请参阅禁止调试佣金发现通知。
开发者实用程序
在“设置”屏幕中,您还可以访问开发者实用程序。
如需查看 Logcat 中的设备和用户偏好设置 DataStore 代码库的内容,请完成以下步骤:
点击记录代码库内容。
点击对话框中的 OK,然后点击 Logcat。
反馈和帮助
如需就我们如何借助 Sample App for Matter 提升开发体验提交您的想法或反馈,请填写反馈表单。
如果您在使用 Sample App for Matter 时遇到问题,请尝试完成验证环境的步骤:
如果您对使用示例应用有疑问或发现代码 bug,可以在 GitHub 代码库中向问题跟踪器提交问题:
如需获得 Google 关于技术问题的官方指导,请使用智能家居开发者论坛:
如需从社区获得技术支持,请在 Stack Overflow 上使用 google-smart-home
标记: