家庭移动 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)。
  • 第二个用于设备制造商的首选应用（如果已在与设备的 VID 或 PID 关联的 Developer Console 项目中定义）。设备制造商首选的委托人应用

应用在选择应用屏幕上的情况有两种。

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