Расширение Google Home для VS Code

Matter Cloud-to-Cloud Local Home SDK SDK для устройств

Google Home Extension for Visual Studio Code разработано и создано для разработчиков платформы Google Home. Это расширение дает вам доступ к Google Assistant Simulator , Google Cloud Logging , Home Graph Viewer и другим инструментам, которые упрощают процесс разработки Matter и умного дома.

Расширение Google Home для VS Code

Возможности расширения Google Home

Симулятор Google Ассистента

Чтобы проверить, правильно ли работают ваши устройства умного дома с экосистемой Google Home, вы можете в любое время взаимодействовать с Assistant Simulator , не выходя из VS Code.

Подобно существующему симулятору, представленному в консоли действий, Assistant Simulator позволяет вам легко управлять устройствами, вводя запросы, например «Включи свет». Внутри VS Code Assistant Simulator отвечает текстовыми сообщениями на основе ваших команд, например: «Хорошо, включаю свет». Дополнительные сведения см. в разделе «Использование симулятора Google Assistant» .

Пакетные высказывания

Чтобы протестировать интеграцию с Google Home как автомат, вы можете отправить пакетные высказывания в Google Assistant Simulator , запустив сценарий высказывания. Дополнительные сведения см. в разделе «Выполнение пакетных высказываний» .

Инструменты регистрации материи

Инструменты ведения журнала Matter могут собирать все журналы, связанные с отладкой Matter, включая журналы Google Home app (GHA) и журналы сервисов Google Play (GMS Core). Журналы можно просмотреть в VS Code с помощью фильтров и поиска по ключевым словам. Журналы можно загрузить с дополнительной информацией об отладке, такой как версия Android и приложения, и отправить их в Google для сообщения о проблемах.

Регистрация вопросов расширения Google Home

Облачная регистрация

Cloud Logging предоставляет информацию об отладке и ключевые показатели, позволяющие получить представление об использовании вашего действия. Чтобы упростить разработку, Google Home Extension отображает сообщения Google Cloud Logging в реальном времени рядом с вашим кодом во время устранения неполадок. Дополнительные сведения см. в разделе «Просмотр облачной регистрации» .

Домашний просмотрщик графиков

Средство просмотра домашнего графика теперь доступно непосредственно в Google Home Extension , так что вы можете проверить состояние устройства в своем домашнем графике внутри VS Code. Дополнительные сведения см. в разделе «Просмотр домашнего графика и запуск тестов» .

Установите расширение Google Home для VS Code

Чтобы установить Google Home Extension , выполните следующие действия из VS Code:

  1. Нажмите значок «Расширения» на панели действий .
  2. Найдите google home и нажмите «Установить» .

    Торговая площадка Google Home Extension

Вы также можете загрузить 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 от вашего имени.

  1. Нажмите значок Google Home на панели действий , чтобы открыть Google Home Extension .

    Значок расширения Google Home
  2. Нажмите «Войти через Google» , чтобы открыть окно входа в систему в браузере.

    VS Code Войти в Google
  3. Выберите учетную запись, связанную с вашими устройствами умного дома.

  4. На странице авторизации «Войти с помощью Google» нажмите «Разрешить» .

  5. Откроется вкладка браузера и появится диалоговое окно «Открыть код Visual Studio» . Нажмите «Открыть код Visual Studio» , чтобы продолжить.

    Открыть диалоговое окно VS Code
  6. Вы будете перенаправлены на VS Code, где требуется ваше разрешение, чтобы позволить Google Home Extension открыть URI. Нажмите «Открыть» , чтобы завершить процесс входа в систему.

    Разрешить Google Home Extension открывать URI
  7. После входа в систему Google Home Extension загрузит ваши проекты. После этого нажмите «Выбрать проект» .

    Выберите проект
  8. В появившемся раскрывающемся списке «Найти и выбрать проект» выберите проект умного дома.

Установите инструмент Android Debug Bridge (ADB)

Чтобы просмотреть журналы Matter на телефоне Android , вам необходимо установить ADB:

  1. Установите ADB на свой компьютер.
  2. Включите параметры разработчика и отладку по USB на своем телефоне Android.

Установите инструменты SoC Matter Device

Чтобы просмотреть журналы отладки с устройств Matter :

  1. Большинство SoC устройств экспортируют последовательные порты, такие как /dev/ttyUSBx в Linux или /dev/tty.SLAB_USBtoUART или /dev/tty.usbserial в MacOS. LogViewer может читать журнал напрямую с устройства.
  2. Некоторые типы SoC, такие как NXP или Silicon Labs, могут потребовать установки внешних инструментов (например, JLink). Дополнительную информацию см. в разделе Поддерживаемые устройства .

Используйте расширение Google Home для VS Code

Посмотреть ресурсы для разработчиков

В разделе «ПОМОЩЬ И ОБРАТНАЯ СВЯЗЬ» нажмите «Начало работы и ресурсы» , чтобы открыть страницу «Ресурсы» , где вы сможете найти полезную информацию для разработки с помощью экосистемы Google Home.

Ресурсы для домашней экосистемы Google

Используйте симулятор Google Ассистента

Чтобы открыть Assistant Simulator в VS Code, нажмите GOOGLE ASSISTANT SIMULATOR на боковой панели . В поле «Сообщение» введите запрос и нажмите Enter .

Вы можете просмотреть ответы Assistant Simulator и нажать кнопку после запроса, чтобы отправить его повторно.

Используйте симулятор Google Ассистента

Запуск пакетных высказываний

Наведите указатель мыши на строку меню GOOGLE ASSISTANT SIMULATOR и выберите один из следующих вариантов настройки скриптов:

  • Нажмите , чтобы открыть существующие сценарии высказываний.

  • Нажмите , чтобы сохранить историю в скрипте *.utterance .

    Значки меню пакетных высказываний

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

  • Нажмите , чтобы выбрать сценарий высказывания в раскрывающемся окне.
  • Откройте файл *.utterance напрямую и нажмите .

    Значок запуска пакетных высказываний

Просмотр облачных журналов

В разделе «БЫСТРЫЙ ДОСТУП» нажмите «Журналы облака» , чтобы открыть страницу «Журналы облака» , где вы сможете найти журналы, принадлежащие выбранному вами проекту.

Используйте облачную регистрацию

Пользователи могут фильтровать журналы по серьезности и временному диапазону.

Фильтрация журналов по серьезности и времени

По умолчанию журналы ограничены 50 строками. Если пользователь хочет просмотреть больше журналов, прокрутите вниз и нажмите «Еще» , чтобы просмотреть больше журналов.

Посмотреть больше журналов

Просмотр домашнего графика и запуск тестов

В разделе «БЫСТРЫЙ ДОСТУП» нажмите «Домашняя программа просмотра графиков» , чтобы открыть панель «Домашняя программа просмотра графиков» , где вы сможете найти устройства, принадлежащие выбранному проекту. Вы также можете нажать «Выполнить тест» , чтобы запустить тесты устройства.

Домашний просмотрщик графиков

Это запустит набор тестов в вашем браузере, когда ваше устройство будет выбрано и готово к тестированию. Нажмите «Пуск» и дождитесь результатов теста.

Тестовый набор Google Home

Вы можете проверить детали теста и просмотреть журналы после завершения всех тестов.

Результаты теста

Используйте расширение Google Home для отладки Matter

Android-журналирование

В разделе «ИНСТРУМЕНТЫ РЕГИСТРАЦИИ МАТЕРИАЛА» нажмите «Журналы Android » , чтобы открыть страницу «Журналы Android » , выберите телефон Android , к которому вы хотите подключиться, и начните отображать журналы.

Android-журналирование

После подключения телефона Android вы сможете просматривать журналы построчно. Обратите внимание, что журналы фильтруются, что означает, что отображаются только журналы, относящиеся к GHA и модулю Matter Google Play services . Вы также можете установить уровень серьезности для фильтрации журналов или поиска по ключевому слову в журналах.

Журналирование Android отфильтровано

Журналирование устройства Matter

В разделе «ИНСТРУМЕНТЫ РЕГИСТРАЦИИ MATTER LOGGING» нажмите «Журналы устройств» , чтобы открыть страницу «Ресурсы» , сначала выберите «Тип SoC» :

Регистрация устройства Matter

Далее выберите Устройство Материи :

Выбор устройства для регистрации устройства

Затем вы сможете получить все журналы устройства с устройства и использовать такие фильтры, как «Серьезность» и «Поиск» , чтобы найти интересующую вас информацию.

Журналирование с фильтрацией устройства Matter

Скачать все журналы материи

В разделе «БЫСТРЫЙ ДОСТУП» нажмите «Загрузить журналы» , чтобы открыть диалоговое окно «Загрузить журналы» , выберите журналы для загрузки и нажмите «ОК» .

Скачать журналы материи

Выберите папку для загрузки журналов и нажмите «Сохранить» :

Сохранить журнал дел

Затем журналы будут сохранены в папку назначения:

Папка назначения журнала дел

Извлеките сохраненный zip-файл, он покажет информацию об устройстве и файлы журналов.

Zip-файл журнала материи

Файл информации об устройстве будет содержать всю информацию о версии, необходимую для устранения проблем.

Отладка журнала вопросов

Отправить отзыв

Чтобы поделиться своими мыслями или отзывами о том, как мы можем улучшить процесс разработки с помощью Google Home Extension , выберите один из следующих вариантов:

  • На панели ПОМОЩЬ И ОБРАТНАЯ СВЯЗЬ нажмите «Оставить отзыв» , чтобы оставить нам предложения.
  • На панели «СПРАВКА И ОБРАТНАЯ СВЯЗЬ» нажмите «Сообщить о проблеме» , чтобы сообщить о любой проблеме, обнаруженной вами с Google Home Extension
Иконка «Отправить отзыв»
  • Мы также добавили значок обратной связи на странице «Ресурсы» .