家庭移动 SDK 调试

本页面介绍了 Google Home Mobile SDK 中部分 Commissioning API 功能的用法。

禁止显示可佣金发现通知

Android 半页通知
图 1：Android 半页通知示例

默认情况下，Android 上的 Google Play services 会使用覆盖移动设备屏幕下半部分的“半页”通知，主动向用户指示附近有可调试的 Matter 设备。

为防止应用在前台运行时受到干扰，您可以通过在 Mobile SDK 中调用 suppressHalfSheetNotification() 方法来抑制这些通知。如需了解详情，请参阅 API 文档。

如果您的应用在前台运行超过 15 分钟，此 API 启用的抑制功能会超时。如需在超时后重新启用抑制，请再次调用 suppressHalfSheetNotification()，否则半页通知将开始显示。

您可以在 Google Home Sample App for Matter 中找到此 API 的实现。如需了解详情，请参阅 HalfSheetSuppressionObserver.kt。

指明对 Matter 调试的支持

如果您使用 Mobile SDK 进行配置，则必须在 Google Home Developer Console 中添加应用软件包名称，实现我们的 Matter API，并通过处理 ACTION_COMMISSION_DEVICE intent 表明您的应用支持 Matter 配置。

将以下 intent-filter 添加到 AndroidManifest.xml 文件中的 application 声明：

<intent-filter>
    <action android:name="com.google.android.gms.metadata.MODULE_DEPENDENCIES" />
</intent-filter>

如需参考，请参阅我们的示例应用的清单。

应用选择器

应用选择器

在调试过程中，您的应用会通过以下两种方式显示在应用选择器中：

  1. 在选择应用界面上。
  2. 如果用户选择选择其他应用，该应用将显示在其他已安装的应用屏幕上。

推荐的应用

应用选择器会显示两个推荐的应用。

  • 第一个始终为 Google Home app (GHA)。
  • 第二个是设备制造商的首选应用，前提是该应用是在与设备的 VID 或 PID 关联的 Developer Console 项目中定义的。设备制造商首选的调试器应用

当应用位于选择应用屏幕上时，会出现两种情况。

  1. 已安装 - Play services 检查应用是否支持 ACTION_COMMISSION_DEVICE intent 过滤器。如果缺少 intent 过滤器，系统会将用户引导至 Play 商店以更新应用。
  2. 未安装 - 系统会引导用户前往 Play 商店安装应用，然后才能继续。