本页将介绍 Google Home Mobile SDK 中部分调试 API 功能的用法。
禁止显示含佣发现通知
默认情况下,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>
如需查看参考信息,请参阅我们的示例应用清单。
应用选择器
在调试过程中,应用通过两种方式显示在应用选择器中:
- 在选择应用屏幕上。
- 如果用户选择选择其他应用,则该应用会显示在已安装的其他应用屏幕上。
推荐的应用
应用选择器会显示两个推荐的应用。
- 第一个值始终为 Google Home app (GHA)。
- 第二个请求适用于设备制造商的首选应用(前提是已在与设备的 VID 或 PID 关联的 Developer Console 项目中定义该应用)。
在两种情况下,选择应用屏幕上会显示这些应用。
- 已安装 - Play services 检查应用是否支持
ACTION_COMMISSION_DEVICE
intent 过滤器。如果缺少 intent 过滤器,则会将用户定向到 Play 商店以更新应用。 - 未安装 - 用户被定向到 Play 商店以安装应用,然后再继续操作。