SDK для локального домашнего компьютера Matter Cloud-to-cloud
Google Home Extension for Visual Studio Code разработано и создано для разработчиков платформы Google Home. Это расширение дает вам доступ к Google Assistant Simulator , Google Cloud Logging , Home Graph Viewer и другим инструментам для упрощения процесса разработки Matter и умного дома.
Возможности расширения Google Home
Симулятор Google Ассистента
Чтобы проверить, правильно ли работают ваши устройства умного дома с экосистемой Google Home, вы можете в любое время взаимодействовать с Assistant Simulator не выходя из VS Code.
Assistant Simulator позволяет вам легко управлять вашими устройствами, вводя запросы, например, «Включи свет». Внутри VS Code Assistant Simulator отвечает текстовыми сообщениями на основе ваших команд, например, «Хорошо, включаю свет». Подробнее см. в разделе Использование Google Assistant Simulator .
Пакетные высказывания
Чтобы протестировать интеграцию Google Home как автомат, вы можете отправить пакетные высказывания в Google Assistant Simulator, запустив скрипт высказывания. Подробнее см. в разделе Запуск пакетных высказываний .
Инструменты для регистрации материи
Matter Logging Tools может собирать все журналы, связанные с отладкой Matter , включая журналы Google Home app (GHA) и журналы служб Google Play (GMS Core). Журналы можно просматривать в VS Code с помощью фильтров и поиска по ключевым словам. Журналы можно загружать с дополнительной отладочной информацией, такой как версия Android и приложения, и отправлять в Google для сообщения о проблемах.
Ведение журнала в облаке
Cloud Logging предоставляет отладочную информацию и ключевые показатели, чтобы дать вам представление об использовании вашего действия. Для упрощения разработки Google Home Extension показывает сообщения Google Cloud Logging в реальном времени прямо рядом с вашим кодом во время устранения неполадок. Подробнее см. в разделе Просмотр Cloud Logging .
Просмотрщик графиков дома
Home Graph Viewer теперь доступен непосредственно в Google Home Extension так что вы можете проверить состояние устройства в вашем Home Graph внутри VS Code. Подробнее см. в разделах Просмотр Home Graph и Запуск тестов .
Установить расширение Google Home для VS Code
Чтобы установить Google Home Extension , выполните следующие действия в VS Code:
- Щелкните значок «Расширения» на панели действий .
Найдите
google home, затем нажмите Установить .
Вы также можете загрузить Google Home Extension непосредственно из VS Code Marketplace .
Загрузить Google Home Extension
Настройка расширения Google Home для VS Code
После установки Google Home Extension и перезагрузки VS Code вам необходимо будет войти в систему и выбрать проект, прежде чем вы сможете использовать Assistant Simulator и просматривать облачные журналы.
Войдите через Google и выберите облачный проект
Вы можете войти в свою учетную запись разработчика из Google Home Extension , разрешив VS Code взаимодействовать со службами Google от вашего имени.
Нажмите значок Google Home на панели действий , чтобы открыть Google Home Extension .
Нажмите «Войти через Google» , чтобы открыть окно входа в браузере.
Выберите учетную запись, связанную с вашими умными домашними устройствами.
На странице авторизации «Войти через Google» нажмите Разрешить .
Откроется вкладка браузера и появится диалоговое окно Open Visual Studio Code . Нажмите Open Visual Studio Code , чтобы продолжить.
Вы будете перенаправлены в VS Code, где требуется ваше разрешение, чтобы разрешить Google Home Extension открыть URI. Нажмите «Открыть» , чтобы завершить процесс входа.
После входа в систему Google Home Extension загрузит ваши проекты. После этого нажмите Select a project .
В появившемся раскрывающемся окне «Поиск и выбор проекта» выберите свой проект умного дома.
Установите инструмент Android Debug Bridge (ADB)
Чтобы просмотреть журналы Matter на телефоне Android , вам необходимо установить ADB:
- Установите ADB на свой компьютер.
- Включите параметры разработчика и отладку по USB на вашем телефоне Android.
Установить инструменты SoC для устройств Matter
Чтобы просмотреть журналы отладки с устройств Matter :
- Большинство устройств SoC будут экспортировать последовательные порты, такие как
/dev/ttyUSBxна Linux или/dev/tty.SLAB_USBtoUARTили/dev/tty.usbserialна MacOS. LogViewer может читать журнал с устройства напрямую. - Некоторые типы SoC, такие как NXP или Silicon Labs, могут потребовать установки внешних инструментов (например, JLink). Для получения дополнительной информации см. Поддерживаемые устройства .
Используйте расширение Google Home для VS Code
Просмотреть ресурсы для разработчиков
В разделе «СПРАВКА И ОТЗЫВЫ» нажмите «Начало работы и ресурсы» , чтобы открыть страницу «Ресурсы» , где вы найдете полезную информацию для своей разработки с использованием экосистемы Google Home.
Используйте симулятор Google Assistant
Чтобы открыть Assistant Simulator в VS Code, нажмите GOOGLE ASSISTANT SIMULATOR на боковой панели . В поле «Сообщение» введите свой запрос и нажмите Enter .
Вы можете просмотреть ответы Assistant Simulator и нажать кнопку после своего запроса, чтобы отправить его повторно .
Выполнить пакетные высказывания
Наведите курсор на строку меню СИМУЛЯТОРА GOOGLE АССИСТЕНТА и выберите один из следующих вариантов настройки скриптов:
Нажмите , чтобы открыть существующие сценарии высказываний.
Нажмите , чтобы сохранить историю в виде скрипта
*.utterance.
Чтобы начать отправку пакетных высказываний, выберите один из следующих вариантов:
- Нажмите , чтобы выбрать сценарий высказывания из раскрывающегося окна.
Откройте файл
*.utteranceи нажмите .
Просмотр облачного журнала
В разделе БЫСТРЫЙ ДОСТУП нажмите «Журналы облака» , чтобы открыть страницу «Журналы облака» , где вы можете найти журналы, относящиеся к выбранному вами проекту.
Пользователи могут фильтровать журналы по степени серьезности и временному диапазону.
По умолчанию журналы ограничены 50 строками. Если пользователь хочет просмотреть больше журналов, прокрутите страницу вниз и нажмите «Еще» , чтобы просмотреть больше журналов.
Посмотреть график на главной странице и провести тесты
В разделе БЫСТРЫЙ ДОСТУП нажмите Home Graph Viewer , чтобы открыть панель Home Graph Viewer , где вы можете найти устройства, которые относятся к выбранному проекту. Вы также можете нажать Run Test , чтобы запустить тесты для устройства.
Это запустит тестовый набор в вашем браузере с выбранным устройством и готовым к тестированию. Нажмите «Старт» и дождитесь результатов теста.
Вы можете проверить подробности теста и просмотреть журналы после завершения всех тестов.
Используйте расширение Google Home для отладки Matter
Ведение журнала Android
В разделе MATTER LOGGING TOOLS нажмите Android Logs , чтобы открыть страницу Android Logs , выберите телефон Android , к которому вы хотите подключиться, и начните отображать журналы.
После подключения телефона Android вы сможете просматривать журналы построчно. Обратите внимание, что журналы фильтруются, что означает, что отображаются только журналы, связанные с GHA и модулем Google Play services Matter . Вы также можете задать Severity для фильтрации журналов или выполнить поиск по ключевому слову в журналах.
Материя Устройство Регистрация
В разделе MATTER LOGGING TOOLS нажмите Device Logs , чтобы открыть страницу Resources , сначала выберите SoC Type :
Далее выберите устройство Matter :
Затем вы можете получить все журналы устройства и использовать такие фильтры, как «Серьезность» и «Поиск», чтобы найти интересующую вас информацию.
Загрузить все журналы Matter
В разделе БЫСТРЫЙ ДОСТУП нажмите Загрузить журналы , чтобы открыть диалоговое окно «Загрузить журналы» , выберите журналы для загрузки и нажмите ОК .
Выберите папку для загрузки журналов и нажмите «Сохранить» :
Затем журналы будут сохранены в папку назначения:
Извлеките сохраненный zip-файл, в нем будет отображена информация об устройстве и файлы журналов.
Файл с информацией об устройстве будет содержать всю информацию о версии, необходимую для устранения неполадок.
Отправить отзыв
Чтобы отправить свои мысли или отзывы о том, как мы можем улучшить процесс разработки с помощью Google Home Extension , выберите один из следующих вариантов:
- На панели «ПОМОЩЬ И ОБРАТНАЯ СВЯЗЬ» нажмите «Оставить отзыв» , чтобы отправить нам предложения.
- На панели «СПРАВКА И ОБРАТНАЯ СВЯЗЬ» нажмите «Сообщить о проблеме» , чтобы сообщить о любой проблеме, обнаруженной вами в Google Home Extension
- Мы также добавили значок обратной связи на страницу «Ресурсы» .