Главная страница 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 для установки приложения перед продолжением работы.