Расширение 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

Симулятор 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 для сообщения о проблемах.

Облачное ведение журнала

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 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 .

   

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

   

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

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

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

   

6. Вы будете перенаправлены в VS Code, где требуется ваше разрешение, чтобы позволить Google Home Extension открывать 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 Ассистента

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

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

Выполнение пакетных высказываний

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

• Щелкните file_upload , чтобы открыть существующие сценарии произнесения.

• Щелкните file_download , чтобы сохранить историю в виде сценария *.utterance .

  

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

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

• Непосредственно откройте файл *.utterance и нажмите play_arrow .

  

Просмотр облачного ведения журнала

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Чтобы отправить свои мысли или отзывы о том, как мы можем улучшить процесс разработки с помощью 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

Симулятор 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 для сообщения о проблемах.

Облачное ведение журнала

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 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 .

   

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

   

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

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

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

   

6. Вы будете перенаправлены в VS Code, где требуется ваше разрешение, чтобы позволить Google Home Extension открывать 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 Ассистента

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

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

Выполнение пакетных высказываний

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

• Щелкните file_upload , чтобы открыть существующие сценарии произнесения.

• Щелкните file_download , чтобы сохранить историю в виде сценария *.utterance .

  

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

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

• Непосредственно откройте файл *.utterance и нажмите play_arrow .

  

Просмотр облачного ведения журнала

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• Мы также предоставили значок обратной связи на странице ресурсов .