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

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 открывать 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
Иконка «Отправить отзыв»
  • Мы также добавили значок обратной связи на странице «Ресурсы» .