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

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

Подавить уведомления об обнаружении, подлежащие комиссии

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

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

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

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

Реализацию этого 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 store для обновления приложения.
  2. Не установлено — пользователь перенаправляется в Play Store для установки приложения перед продолжением.