Пример приложения Google Home для Matter

Пример приложения Google Home для Matter

Google Home Sample App for Matter использует Google Home Mobile SDK для создания приложения Android, аналогичного Google Home app (GHA) . Этот пример приложения предоставляет следующие функции:

  • Подключите физические и виртуальные устройства Matter к локальной структуре Android.
  • Включите физические и виртуальные устройства в структуру разработки
  • Устройства управления в вашей среде разработки, например включение света.
  • Функции мультиадминистрирования позволяют вам совместно использовать устройства в структуре разработки с другими приложениями и, наоборот, включать в структуру разработки устройства, используемые другими приложениями.
  • Утилиты разработчика

В этом руководстве описывается, как установить APK Sample App for Matter и использовать его для ввода в эксплуатацию, управления и совместного использования устройств Matter .

Чтобы загрузить исходный код, узнать, как интегрировать Mobile SDK и настроить экраны в Android Studio, попробуйте наш Sample App for Matter .

Перейдите к лаборатории Sample App for Matter

Предварительные условия

Вам не нужен концентратор, например Google Nest Hub (2nd gen) , для ввода в эксплуатацию и управления устройствами с помощью Sample App for Matter .

Установить

  1. Перейдите в раздел «Релизы» в репозитории Sample App for Matter на GitHub. Для самой последней версии найдите в разделе «Ресурсы» APK-файл с именем GHSAFM- version -default-debug.apk . Не выбирайте targetcommissioner .

  2. Установите Android Debug Bridge (adb):

    Установить адб

  3. Подключите устройство Android через USB и включите передачу файлов , затем установите APK:

    $ adb unroot && adb install GHSAFM-version-default-debug.apk
    

Комиссионные устройства

При первом запуске примера приложения вы увидите диалоговое окно со ссылкой на Sample App for Matter codelab . Если вы выберете «Больше не показывать это сообщение» , вы сможете вернуть диалоговое окно в любое время, обновив свои настройки в разделе «Администратор» приложения.

На следующих шагах вы добавите устройство Matter в локальную структуру Android, а также структуру разработки, которая является локальной только для примера приложения.

Что такое ткани Matter?

Пример приложения Google Home для Matter

Структура Matter — это общий домен доверия между устройствами в домашней сети, который позволяет им взаимодействовать друг с другом.

Устройства могут иметь одну или несколько структур, соответствующих платформе, приложению или группе устройств, взаимодействующих вместе. Фабрики имеют уникальный идентификатор, а устройства используют один и тот же набор учетных данных и центр сертификации ( CA ). Эти учетные данные присваиваются во время ввода Matter в эксплуатацию.

Для ввода в эксплуатацию устройства Matter выполните следующие действия:

  1. Нажмите кнопку устройство», чтобы начать процесс ввода в эксплуатацию.

    Добавить устройство

  2. Далее управление передается Google Play services , который запускается от обращения к Mobile SDK . Чтобы подтвердить владение, отсканируйте QR-код или коснитесь «Использовать код сопряжения» .

    Сканировать QR-код

  3. После завершения ввода в эксплуатацию введите Имя устройства , затем нажмите «Готово» .

Теперь ваше устройство подключено как к локальной структуре Android, так и к среде разработки.

Все работы по вводу в эксплуатацию и связанные с ними экраны выполняются Play services при вводе устройств в эксплуатацию. Это обеспечивает единообразный пользовательский интерфейс и устраняет необходимость обработки конфиденциальных разрешений, например учетных данных Wi-Fi и потоков.

Устройства управления

Структура разработки создает учетные данные для управления устройствами Matter прямо из примера приложения.

На главном экране вы можете включить или выключить свое устройство. Коснитесь устройства, чтобы получить доступ к сведениям об устройстве.

Устройство добавлено

Поделиться устройствами

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

Чтобы поделиться своим устройством Matter с другими экосистемами, вам потребуется установить другую платформу на ваше устройство Android. Эта внешняя платформа становится целевым комиссаром . Мы создали еще один экземпляр примера приложения, который вы можете использовать в качестве целевого комиссара.

  1. Перейдите в раздел «Релизы» в репозитории Sample App for Matter на GitHub. Для самой последней версии найдите в разделе «Ресурсы» APK-файл с именем GHSAFM- version -targetcommissioner-debug.apk . Не выбирайте значение default .

  2. Установите целевого комиссара.

    $ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apk
    
  3. На главном экране коснитесь устройства, чтобы отобразить информацию об устройстве. Нажмите «Поделиться» .

    Поделиться устройством

Пример приложения вызывает Mobile SDK Share API, и управление снова передается Play services .

Откроется страница общего доступа, позволяющая выбрать приложение или платформу, к которой вы хотите подключить устройство. На этом экране предусмотрено два способа предоставления общего доступа к устройству:

  1. Вручную с помощью кода настройки, который будет передан в приложение целевого комиссара.
  2. С помощью местного приложения для Android, зарегистрированного в качестве комиссара Matter .

Приложение целевого комиссара имеет обозначение GHSAFM-TC . Коснитесь этого экземпляра примера приложения, чтобы поделиться своим устройством.

Далее внешнее приложение (целевой комиссар) завершает ввод устройства в эксплуатацию в собственной фабрике.

Настройки

На главном экране щелкните значок настроек. Здесь у вас есть возможность обновить настройки пользователя, получить помощь и узнать больше о приложении.

Настройки

Уведомление о половине листа

На экране «Настройки» вы можете отключить упреждающие комиссионные уведомления об обнаружении для устройств Matter .

Если ваше приложение предоставляет собственный поток обнаружения или ввода в эксплуатацию Matter , вы можете пожелать подавить эти уведомления, чтобы предотвратить перебои. Дополнительные сведения см. в разделе Подавление уведомлений о комиссионных открытиях .

Утилиты разработчика

На экране «Настройки» вы также можете получить доступ к утилитам разработчика .

Чтобы просмотреть содержимое репозиториев хранилища данных устройств и пользовательских настроек в Logcat , выполните следующие действия:

  1. Нажмите Записывать содержимое репозиториев .

  2. Нажмите «ОК» в диалоговом окне, затем отметьте Logcat .

Обратная связь и помощь

Чтобы поделиться своими мыслями или отзывами о том, как мы можем улучшить процесс разработки с помощью Sample App for Matter , заполните нашу форму обратной связи.

Отправьте нам свой отзыв

Если у вас возникли проблемы с Sample App for Matter , попробуйте выполнить действия, чтобы проверить свою среду:

Если у вас есть вопросы по использованию примера приложения или вы обнаружили ошибку в коде, вы можете отправить сообщение о проблемах в систему отслеживания проблем в репозитории GitHub:

Чтобы получить официальные рекомендации от Google по техническим вопросам, воспользуйтесь форумом разработчиков умного дома:

Чтобы получить техническую поддержку от сообщества, используйте тег google-smart-home в Stack Overflow: