家庭移动 SDK 调试

本页面介绍了如何在 Google Home Mobile SDK中使用部分调试 API 功能。

禁止显示可调试设备发现通知

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

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

为了防止应用在前台运行时出现中断，您可以通过调用 中的 suppressHalfSheetNotification() 方法来禁止显示这些通知。Mobile SDK如需了解详情，请参阅 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 商店以安装应用 ，然后才能继续。