家庭移动 SDK 调试

本页将介绍如何在 Google Home Mobile SDK 中使用部分调试 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)。
  • 第二个 ID 用于设备制造商的首选应用（如果该应用是在与设备的 VID 或 PID 关联的 Developer Console 项目中定义的）。设备制造商首选调试器应用

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

  1. 已安装 - Play services 会检查应用是否支持 ACTION_COMMISSION_DEVICE intent 过滤器。如果缺少 intent 过滤器，系统会将用户定向到 Play 商店以更新应用。
  2. 未安装 - 用户会被定向到 Play 商店以安装应用，然后再继续操作。