Google Home Matter 示例应用

Google Home Matter 示例应用

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

前提条件

您无需使用 hub(例如 Google Nest Hub (2nd gen))即可通过 Sample App for Matter 调试和控制设备。

安装

  1. 前往 Sample App for Matter GitHub 代码库中的“版本”部分。如需获取最新版本,请在“资源”部分找到名为 GHSAFM-version-default-debug.apk 的 APK。请勿选择 targetcommissioner

  2. 安装 Android 调试桥 (adb):

    安装 adb

  3. 将 Android 设备连接到 USB 并启用文件传输,然后安装 APK:

    $ adb unroot && adb install GHSAFM-version-default-debug.apk
    

调试设备

当您首次启动示例应用时,系统会显示一个对话框,其中包含指向 Sample App for Matter Codelab 的链接。如果您选择不再显示此消息,可以随时通过更新应用的“管理”部分中的偏好设置来恢复此对话框。

在接下来的步骤中,您将向本地 Android 架构添加一个 Matter 设备,以及仅在示例应用本地的开发结构。

什么是 Matter 织物?

Google Home Matter 示例应用

Matter 结构是家庭网络中设备之间的共享信任域,使它们能够相互通信。

设备可以有一个或多个结构(对应于一起交互的平台、应用或设备组)。Fabric 具有唯一 ID,并且设备共享同一组凭据和证书授权机构 (CA)。这些凭据在 Matter 调试期间分配。

如需调试 Matter 设备,请完成以下步骤:

  1. 点按 Add Device 按钮以开始调试过程。

    添加设备

  2. 接下来,控制权移交给了 Google Play services,后者通过调用 Mobile SDK 启动。如需出具所有权证明,请扫描二维码或点按使用配对码

    扫描二维码

  3. 调试完成后,输入设备名称,然后点按完成

您的设备现已连接到本地 Android 结构脉络和开发结构脉络。

调试设备时,所有调试工作和关联屏幕均由 Play services 处理。这样可以提供一致的用户体验,并且无需处理敏感权限,例如 Wi-Fi 和线程凭据。

控制设备

开发架构会创建凭据,以直接从示例应用控制 Matter 设备。

在主屏幕上,您可以将设备切换为开启关闭。点按设备即可访问设备详细信息。

已添加设备

共享设备

共用设备在 Matter 规范中称为多管理员流程。将设备调试到示例应用后,您可以轻松地与其他生态系统共享该设备。

如需与其他生态系统共享您的 Matter 设备,您需要在 Android 设备上安装其他平台。该外部平台将成为目标调试器。我们已经创建了示例应用的另一个实例,您可以将其用作目标调试器。

  1. 前往 Sample App for Matter GitHub 代码库中的“版本”部分。如需获取最新版本,请在“资源”部分找到名为 GHSAFM-version-targetcommissioner-debug.apk 的 APK。请勿选择 default

  2. 安装目标调试器。

    $ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apk
    
  3. 在主屏幕上,轻击设备以显示设备信息。点按分享

    共享设备

示例应用调用 Mobile SDK Share API,并且再次将控制权转让给 Play services

系统会显示一个分享表单,供您选择要与设备配对的应用或平台。该屏幕提供了两种共享设备的方式:

  1. 通过要与目标调试器应用共享的设置代码手动运行
  2. 使用已注册为 Matter 调试器的本地 Android 应用

目标调试器应用带有 GHSAFM-TC 标签。点按该示例应用的实例以共享您的设备。

接下来,外部应用(目标调试器)会在自己的结构中完成设备调试。

设置

在主屏幕上,点击“设置”图标 。在这里,您可以选择更新用户偏好设置、获取帮助,以及详细了解应用。

设置

半版通知

在“设置”屏幕中,您可以选择为 Matter 设备停用主动式可佣金发现通知。

如果您的应用提供了自己的 Matter 发现或调试流程,您可能希望禁止这些通知以防止中断。如需了解详情,请参阅抑制含佣金发现通知

开发者实用程序

通过“设置”屏幕,您还可以访问开发者实用程序

如需在 Logcat 中查看设备和用户偏好设置 DataStore 代码库的内容,请完成以下步骤:

  1. 点击 Log repositories content

  2. 点击 OK 以打开对话框,然后勾选 Logcat

反馈和帮助

如果您有关于我们如何改进 Sample App for Matter 开发体验的想法或反馈,请填写我们的反馈表单。

向我们发送反馈

如果您在使用 Sample App for Matter 时遇到问题,请尝试完成以下步骤来验证您的环境:

如果您对使用示例应用有疑问或发现了代码 bug,可以将问题提交到 GitHub 代码库中的问题跟踪器:

如需获得 Google 关于技术问题的官方指导,请访问智能家居开发者论坛:

如需从社区获取技术支持,请在 Stack Overflow 上使用 google-smart-home 标记: