На этой странице описано использование некоторых функций API ввода в эксплуатацию в Google Home Mobile SDK .
Подавить уведомления о комиссионных открытиях
По умолчанию Google Play services на Android используют уведомления «на поллиста», которые закрывают нижнюю половину экрана мобильного устройства, чтобы предоставить пользователям упреждающую индикацию о том, что поблизости находятся платные устройства Matter .
Чтобы предотвратить перебои, пока ваше приложение находится на переднем плане, вы можете отключить эти уведомления, вызвав метод suppressHalfSheetNotification()
в Mobile SDK . Дополнительную информацию см. в документации API.
Время подавления, включенное этим API, истекает, если ваше приложение находится на переднем плане более 15 минут. Чтобы снова включить подавление после тайм-аута, снова вызовите suppressHalfSheetNotification()
, иначе начнут появляться уведомления о половине листа.
Реализацию этого API можно найти в Google Home Sample App for Matter . Дополнительную информацию см. в HalfSheetSuppressionObserver.kt
.
Указать поддержку ввода в эксплуатацию Материи
Если вы используете Mobile SDK для ввода в эксплуатацию, вам необходимо добавить имя пакета приложения в Google Home Developer Console , реализовать наши API-интерфейсы Matter и указать, что ваше приложение поддерживает ввод в эксплуатацию Matter , обрабатывая намерение ACTION_COMMISSION_DEVICE
.
Добавьте следующий intent-filter
в объявление application
в файле AndroidManifest.xml
:
<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
. Если фильтр намерений отсутствует, пользователь перенаправляется в магазин Play для обновления приложения. - Не установлено — пользователь перенаправляется в магазин Play для установки приложения, прежде чем продолжить.