家庭移动 SDK 调试

本页将介绍 Google Home Mobile SDK 中部分调试 API 功能的用法。

禁止显示含佣发现通知

Android 半屏通知
图 1:Android 半页通知示例

默认情况下,Android 上的 Google Play services 使用覆盖移动设备屏幕下半部分的“半屏”通知来主动向用户指明附近有可佣金 Matter 设备。

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

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

此 API 的实现可以在 Google Home Sample App for Matter 中找到。如需了解详情,请参阅 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 商店以安装应用,然后再继续操作。