На этой странице рассказывается, как использовать некоторые функции Commissioning API в Google Home Mobile SDK.
Отключить уведомления о комиссионных
По умолчанию Google Play services на Android использует уведомления в виде полустраницы, которые закрывают нижнюю половину экрана мобильного устройства и сообщают пользователям о том, что поблизости есть устройства Matter, которые можно ввести в эксплуатацию.
Чтобы уведомления не мешали пользователям, когда приложение открыто, вы можете отключить их, вызвав метод suppressHalfSheetNotification() в Mobile SDK. Дополнительную информацию можно найти в документации по API.
Если приложение находится на переднем плане более 15 минут, срок действия подавления, включенного этим API, истекает. Чтобы снова включить подавление после тайм-аута, вызовите suppressHalfSheetNotification() ещё раз. В противном случае уведомления на пол-экрана начнут появляться снова.
Реализацию этого API можно найти в Google Home Sample App for Matter. Подробнее: HalfSheetSuppressionObserver.kt.
Укажите, поддерживается ли ввод в эксплуатацию Matter
Если вы используете Mobile SDK для ввода в эксплуатацию, вам необходимо добавить название пакета приложения в Google Home Developer Console, реализовать наши API Matter и указать, что ваше приложение поддерживает ввод в эксплуатацию Matter, обрабатывая намерение ACTION_COMMISSION_DEVICE.
Добавьте в объявление application в файле AndroidManifest.xml следующий код intent-filter:
<intent-filter>
<action android:name="com.google.android.gms.metadata.MODULE_DEPENDENCIES" />
</intent-filter>
В качестве примера посмотрите манифест нашего приложения.
Выбор приложения
Приложение может появиться в списке выбора двумя способами:
- На экране Выберите приложение.
- Если пользователь нажмет Выбрать другое приложение, оно появится на экране Другие установленные приложения.
Рекомендуемые приложения
В окне выбора приложений показаны два рекомендованных приложения.
- Первый – всегда Google Home app (GHA).
- Вторая – для предпочтительного приложения производителя устройства, если оно определено в проекте Developer Console, связанном с VID или PID устройства.
Приложения на экране Выберите приложение могут быть двух типов.
- Установлено – Play services проверяет, поддерживает ли приложение фильтр интентов
ACTION_COMMISSION_DEVICE. Если фильтр интентов отсутствует, пользователь будет перенаправлен в Google Play, чтобы обновить приложение. - Не установлено. Пользователь перенаправляется в Google Play, чтобы установить приложение.