Пример приложения 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

Предпосылки

  • Устройство Android O (8.1, API level 27) или более новое, доступное для тестирования. Чтобы убедиться, что ваше устройство поддерживает последнюю версию Matter , ознакомьтесь с руководством Verify Matter Modules & Services .
  • Создайте устройство Matter с возможностями включения/выключения. Этот пример приложения работает с виртуальным устройством и ESP32.

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

Установить

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

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

    Установить adb

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

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

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

При первом запуске примера приложения вы получите диалоговое окно со ссылкой на Sample App for Matter codelab . Если вы выберете Don't show this message again , вы сможете вернуть диалоговое окно в любое время, обновив свои настройки в разделе Admin приложения.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  2. Назначьте целевого комиссара.

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

  3. На главном экране нажмите на устройство, чтобы отобразить информацию об устройстве. Нажмите « Поделиться» .

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

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

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

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

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

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

Настройки

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

Настройки

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

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

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

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

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

Чтобы просмотреть содержимое репозиториев Device и User Preferences DataStore в Logcat , выполните следующие действия:

  1. Нажмите Содержимое репозиториев журналов .

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

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

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

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

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

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

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

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