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 27) или более поздней версии. Чтобы убедиться, что на вашем устройстве установлена последняя версия поддержки Matter , ознакомьтесь с руководством по проверке модулей и служб Matter .
- Создайте устройство Matter с возможностью включения/выключения. Этот пример приложения работает с виртуальным устройством и ESP32.
- Виртуальное устройство материи (МВД) . Чтобы свести к минимуму проблемы с окружающей средой, мы настоятельно рекомендуем вам начать с MVD. Если вы когда-нибудь столкнетесь с проблемами, вам будет гораздо проще выяснить, используется ли образец приложения против MVD.
- Создайте виртуальное устройство Matter с помощью приложения
rootnode_dimmablelight_bCwGYSDpoe. При создании интеграции Matter в Google Home Developer Console используйте0xFFF1в качестве идентификатора поставщика и0x8000в качестве идентификатора продукта. - Создайте устройство для эспрессо с помощью
all-clusters-app. При создании интеграции Matter в Developer Console используйте0xFFF1в качестве идентификатора поставщика и0x8001в качестве идентификатора продукта.
Вам не нужен концентратор, например Google Nest Hub (2nd gen) , для ввода в эксплуатацию и управления устройствами с помощью Sample App for Matter .
Установить
Перейдите в раздел «Релизы» в репозитории Sample App for Matter на GitHub. Для самой последней версии найдите в разделе «Ресурсы» APK-файл с именем
GHSAFM- version -default-debug.apk. Не выбирайтеtargetcommissioner.Установите Android Debug Bridge (adb):
Подключите устройство Android через USB и включите передачу файлов , затем установите APK:
$ adb unroot && adb install GHSAFM-version-default-debug.apk
Комиссионные устройства
При первом запуске примера приложения вы увидите диалоговое окно со ссылкой на тестовую лабораторию Sample App for Matter . Если вы выберете «Больше не показывать это сообщение» , вы сможете вернуть диалоговое окно в любое время, обновив свои настройки в разделе «Администратор» приложения.
На следующих шагах вы добавите устройство Matter в локальную структуру Android, а также структуру разработки, которая является локальной только для примера приложения.
Что такое ткани Matter?
Структура Matter — это общий домен доверия между устройствами в домашней сети, который позволяет им взаимодействовать друг с другом.
Устройства могут иметь одну или несколько фабрик, соответствующих платформе, приложению или группе устройств, взаимодействующих вместе. Фабрики имеют уникальный идентификатор, а устройства используют один и тот же набор учетных данных и центр сертификации ( CA ). Эти учетные данные присваиваются во время ввода Matter в эксплуатацию.
Для ввода в эксплуатацию устройства Matter выполните следующие действия:
Нажмите кнопку устройство», чтобы начать процесс ввода в эксплуатацию.
Далее управление передается Google Play services , который запускается от обращения к Mobile SDK . Чтобы подтвердить владение, отсканируйте QR-код или коснитесь «Использовать код сопряжения» .
После завершения ввода в эксплуатацию введите Имя устройства , затем нажмите « Готово» .
Теперь ваше устройство подключено как к локальной структуре Android, так и к среде разработки.
Все работы по вводу в эксплуатацию и связанные с ними экраны выполняются Play services при вводе устройств в эксплуатацию. Это обеспечивает единообразный пользовательский интерфейс и устраняет необходимость обработки конфиденциальных разрешений, например учетных данных Wi-Fi и потоков.
Устройства управления
Структура разработки создает учетные данные для управления устройствами Matter прямо из примера приложения.
На главном экране вы можете включить или выключить свое устройство. Коснитесь устройства, чтобы получить доступ к сведениям об устройстве.
Поделиться устройствами
В спецификации Matter совместное использование устройства называется потоком нескольких администраторов . После того как устройство будет подключено к примеру приложения, вы сможете легко поделиться им с другими экосистемами.
Чтобы поделиться своим устройством Matter с другими экосистемами, вам потребуется установить другую платформу на ваше устройство Android. Эта внешняя платформа становится целевым комиссаром . Мы создали еще один экземпляр примера приложения, который вы можете использовать в качестве целевого комиссара.
Перейдите в раздел «Релизы» в репозитории Sample App for Matter на GitHub. Для самой последней версии найдите в разделе «Ресурсы» APK-файл с именем
GHSAFM- version -targetcommissioner-debug.apk. Не выбирайте значениеdefault.Установите целевого комиссара.
$ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apkНа главном экране коснитесь устройства, чтобы отобразить информацию об устройстве. Нажмите « Поделиться» .
Пример приложения вызывает Mobile SDK Share API, и управление снова передается Play services .
Откроется страница общего доступа, позволяющая выбрать приложение или платформу, к которой вы хотите подключить устройство. На этом экране предусмотрено два способа предоставления общего доступа к устройству:
- Вручную с помощью кода настройки, который будет передан в приложение целевого комиссара.
- С помощью местного приложения для Android, зарегистрированного в качестве комиссара Matter .
Приложение целевого комиссара имеет обозначение GHSAFM-TC . Коснитесь этого экземпляра примера приложения, чтобы поделиться своим устройством.
Далее внешнее приложение (целевой комиссар) завершает ввод устройства в эксплуатацию в собственной фабрике.
Настройки
На главном экране щелкните значок настроек. Здесь у вас есть возможность обновить настройки пользователя, получить помощь и узнать больше о приложении.
Уведомление о половине листа
На экране «Настройки» вы можете отключить упреждающие комиссионные уведомления об обнаружении для устройств Matter .
Если ваше приложение предоставляет собственный процесс обнаружения или ввода в эксплуатацию Matter , вы можете пожелать подавить эти уведомления, чтобы предотвратить перебои. Дополнительные сведения см. в разделе Подавление уведомлений о комиссионных открытиях .
Утилиты разработчика
На экране «Настройки» вы также можете получить доступ к утилитам разработчика .
Чтобы просмотреть содержимое репозиториев хранилища данных устройств и пользовательских настроек в Logcat , выполните следующие действия:
Нажмите Записывать содержимое репозиториев .
Нажмите «ОК» в диалоговом окне, затем отметьте Logcat .
Обратная связь и помощь
Чтобы поделиться своими мыслями или отзывами о том, как мы можем улучшить процесс разработки с помощью Sample App for Matter , заполните нашу форму обратной связи.
Если у вас возникли проблемы с Sample App for Matter , попробуйте выполнить действия, чтобы проверить свою среду:
Если у вас есть вопросы по использованию примера приложения или вы обнаружили ошибку в коде, вы можете отправить сообщение о проблемах в систему отслеживания проблем в репозитории GitHub:
Чтобы получить официальные рекомендации от Google по техническим вопросам, воспользуйтесь форумом разработчиков умного дома:
Чтобы получить техническую поддержку от сообщества, используйте тег google-smart-home в Stack Overflow: