Главная страница Mobile SDK Ввод в эксплуатацию

На этой странице рассматривается использование некоторых функций API ввода в эксплуатацию в Google Home Mobile SDK .

Запретить уведомления о раскрытии информации, подлежащие выплате комиссионных.

Уведомление Android Halfsheet
Рисунок 1: Пример уведомления в формате «половина листа» на Android.

По умолчанию Google Play services на Android используют уведомления в виде «половинного экрана», которые закрывают нижнюю половину экрана мобильного устройства, чтобы заблаговременно оповестить пользователей о том, что поблизости находятся устройства Matter подлежащие вводу в эксплуатацию.

Чтобы предотвратить прерывания работы приложения в фоновом режиме, вы можете отключить эти уведомления, вызвав метод suppressHalfSheetNotification() в Mobile SDK . Дополнительную информацию см. в документации API.

Функция подавления уведомлений, включенная в этот API, отключается по истечении времени ожидания, если ваше приложение находится на переднем плане более 15 минут. Чтобы повторно включить подавление после истечения времени ожидания, вызовите функцию suppressHalfSheetNotification() еще раз, иначе начнут появляться уведомления в виде половинных листов.

Пример реализации этого API можно найти в Google Home Sample App for Matter . Дополнительную информацию см. в файле HalfSheetSuppressionObserver.kt .

Выразите поддержку введению Matter в эксплуатацию.

Если вы используете 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>

Для получения дополнительной информации ознакомьтесь с манифестом нашего примера приложения .

выбор приложений

выбор приложений

В процессе ввода приложения в эксплуатацию ваше приложение будет отображаться в списке приложений двумя способами:

  1. На экране «Выберите приложение» .
  2. Если пользователи выберут «Выбрать другое приложение» , оно отобразится на экране «Другие установленные приложения» .

Рекомендуемые приложения

В окне выбора приложений отображаются два рекомендуемых приложения.

  • Первым всегда является Google Home app (GHA) .
  • Второй вариант предназначен для предпочтительного приложения производителя устройства, если оно определено в проекте Developer Console , связанном с VID или PID устройства. Приложение, предпочитаемое производителями устройств для комиссаров.

При выборе приложения на экране «Выберите приложение» возможны два сценария.

  1. Установлено — Play services проверяют, поддерживает ли приложение фильтр намерений ACTION_COMMISSION_DEVICE . Если фильтр намерений отсутствует, пользователь перенаправляется в магазин Play для обновления приложения.
  2. Приложение не установлено — пользователю предлагается перейти в магазин Play Store для установки приложения перед продолжением.