家庭移动 SDK 调试

本页面介绍了 Google Home Mobile SDK 中部分调试 API 功能的使用情况。

禁止显示可赚取佣金的发现通知

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

默认情况下，Google Play services 在 Android 上使用“半屏”通知，该通知会覆盖移动设备屏幕的下半部分，主动向用户指示附近有可赚取佣金的 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 商店，以便用户先安装应用，然后再继续。