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