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

Matter Cloud-to-cloud Local Home SDK Device 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 в режиме реального времени рядом с вашим кодом во время устранения неполадок. Дополнительные сведения см. в разделе Просмотр ведения журнала в облаке .

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

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

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

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

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

    Магазин домашних расширений Google

Вы также можете загрузить 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 Код Google Войти
  3. Выберите учетную запись, связанную с вашими устройствами умного дома.

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

  5. Откроется вкладка браузера и отобразится диалоговое окно Open Visual Studio Code . Щелкните Открыть код 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.

Установите Matter Device SoC Tools

Чтобы просмотреть журналы отладки с устройств 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

В разделе MATTER LOGGING TOOLS нажмите Журналы Android , чтобы открыть страницу Журналы Android , выберите телефон Android , к которому вы хотите подключиться, и начните показывать журналы.

Ведение журнала Android

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

Ведение журнала Android отфильтровано

Ведение журнала устройств Matter

В разделе MATTER LOGGING TOOLS щелкните Device Logs , чтобы открыть страницу Resources , сначала выберите SoC Type :

Ведение журнала устройства Matter

Затем выберите Matter Device :

Выбор устройства регистрации устройства Matter

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

Отфильтрованное ведение журнала устройства Matter

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

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

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

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

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

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

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

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

Zip-файл журнала Matter

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

Отладка журнала материи

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

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

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

Matter Cloud-to-cloud Local Home SDK Device 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 в режиме реального времени рядом с вашим кодом во время устранения неполадок. Дополнительные сведения см. в разделе Просмотр ведения журнала в облаке .

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

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

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

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

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

    Магазин домашних расширений Google

Вы также можете загрузить 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 Код Google Войти
  3. Выберите учетную запись, связанную с вашими устройствами умного дома.

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

  5. Откроется вкладка браузера и отобразится диалоговое окно Open Visual Studio Code . Щелкните Открыть код 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.

Установите Matter Device SoC Tools

Чтобы просмотреть журналы отладки с устройств 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

В разделе MATTER LOGGING TOOLS нажмите Журналы Android , чтобы открыть страницу Журналы Android , выберите телефон Android , к которому вы хотите подключиться, и начните показывать журналы.

Ведение журнала Android

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

Ведение журнала Android отфильтровано

Ведение журнала устройств Matter

В разделе MATTER LOGGING TOOLS щелкните Device Logs , чтобы открыть страницу Resources , сначала выберите SoC Type :

Ведение журнала устройства Matter

Затем выберите Matter Device :

Выбор устройства регистрации устройства Matter

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

Отфильтрованное ведение журнала устройства Matter

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

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

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

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

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

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

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

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

Zip-файл журнала Matter

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

Отладка журнала материи

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

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

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