家庭移动 SDK 调试

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

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

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

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