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

Уведомление о безопасности
Чтобы запретить Android Studio хранить секреты и пароли, выполните следующие действия:
- Нажмите Файл , затем Настройки... .
- В разделе «Внешний вид и поведение» разверните «Системные настройки» и нажмите «Пароли» .
- Выберите Не сохранять, забыть пароли после перезагрузки.

Функции
Симулятор помощника
Чтобы проверить, правильно ли работают ваши умные домашние устройства с экосистемой Google Home, вы можете в любой момент взаимодействовать с Assistant Simulator , не выходя из Android Studio .
Подобно существующему симулятору помощника, представленному в консоли Actions on Google Console , Assistant Simulator позволяет вам легко управлять своими устройствами, вводя запросы, например «Включите свет». В Android Studio Assistant Simulator отвечает текстовыми сообщениями на основе ваших команд, например, «Хорошо, включаю свет».

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

Пакетные высказывания
Ответы Assistant Simulator на одно высказывание не являются детерминированными. Например, ответом может быть любая из следующих фраз:
- Понял, включил 2 лампочки.
- Конечно, включив 2 лампочки.
- Понял, загорелись 2 лампочки.
- Хорошо, включаю 2 лампочки.
Чтобы запустить автоматические тесты и проверить, как ваши интеграции Google работают с этими различными ответами, вы можете отправить пакетные высказывания в Assistant Simulator , запустив сценарии высказываний. После сохранения сценария вы можете собирать ответы и запускать несколько тестов по своим запросам.
Домашний просмотрщик графиков
Home Graph Viewer позволяет отображать состояние ваших устройств и запускать Google Home Test Suite в браузере.
Средство просмотра журнала Android Debug Bridge (adb)
Adb Log Viewer — это инструмент для просмотра и анализа файлов журналов, например файлов журналов устройств Matter , журналов Google Home и журналов Android.
Установить
Чтобы установить Google Home Plugin в Android Studio , выполните следующие действия:
- Загрузите или обновите Android Studio . Скачать Android-студию
- Перейдите в меню «Файл» > «Настройки» ( Android Studio > «Настройки» в MacOS).
- В разделе «Плагины» перейдите в Marketplace и найдите
google home
. - Установите инструмент и перезапустите Android Studio .
Вы также можете загрузить подключаемый модуль непосредственно с JetBrains Marketplace .
Настраивать
После установки плагина вам необходимо выполнить следующие шаги, прежде чем вы сможете использовать Assistant Simulator и просматривать облачное ведение журнала:
Войти через Google
Вы можете войти в свою учетную запись разработчика с панели Google Home, разрешив Android Studio взаимодействовать со службами Google от вашего имени.
Щелкните вкладку Google Home в столбце вертикальной вкладки в левой части окна Android Studio .
Для входа с помощью нажмите Google , чтобы запустить браузер.
Выберите учетную запись, связанную с вашими умными домашними устройствами.
На странице авторизации Войти с помощью Google нажмите Разрешить .
Закройте окно браузера и вернитесь в Android Studio .
Теперь вы должны войти в систему с возможностью выхода .
Выберите облачный проект
После входа в систему выберите проект из раскрывающегося списка. Чтобы отфильтровать список проектов, введите выражение фильтра , например, matter
, затем нажмите Enter
.
В раскрывающемся списке Project загружаются первые 100 проектов на основе вашего фильтра . Ваш выбор сохраняется при выходе из Android Studio .

Справку по фильтрам проектов см. в разделе Параметры запроса в Google Cloud Reference.
Используйте симулятор помощника
Чтобы открыть Assistant Simulator в Android Studio , нажмите «Панель высказываний» на панели Google Home Plugin .

Существует несколько способов отправки запросов в Assistant Simulator . Далее мы рассмотрим каждый вариант.
Введите запросы и соберите ответы
Чтобы взаимодействовать с Assistant Simulator , введите запрос и нажмите Enter.
Вы можете повторно отправить запрос, щелкнув значок
повторной отправки в конце запроса.После отправки одного или нескольких запросов нажмите
повтор , чтобы повторно выполнить запросы и проверить свои ответы. Панель «Высказывания» отслеживает ваши запросы и ответы в сохраненном кеше. Воспроизведение только добавляет новые ответы в этот внутренний кэш и не будет дублировать ваши запросы каждый раз, когда вы нажимаете кнопку.
Нажмите
» , чтобы сохранить запросы и ответы, которые вы ввели на панели «Высказывания» . Ваши взаимодействия преобразуются в JSON в следующем формате:-
ask
: Ваш запрос. -
answers
: Массив возможных ответов Assistant Simulator .
Вы можете редактировать этот файл JSON в Android Studio .
{
"collected": false,
"lines": [
{
"ask": "turn lights on",
"answers": [
"OK, turning 2 lights on.",
"Sure, turning on 2 lights."
]
}
]
}
Сбор пакетных ответов
На панели Google Home Plugin нажмите «Файл высказываний» , чтобы открыть сохраненные файлы JSON на новой вкладке. Для Select Path вы можете выбрать файл или папку. Если вы выберете папку, сбор и проверка будут работать со всеми файлами .json
высказываний в этой папке.
Вы можете открыть несколько вкладок для одного и того же файла или разных файлов, например, lights
, lights(1)
и plug
.
В строке состояния отображается результат вашего последнего теста (если применимо), желтая или зеленая точка, указывающая, был ли собран файл, и путь к файлу .json
произнесения. После того, как вы нажмете Collect , Assistant Simulator выполнит ваши запросы. Вы будете уведомлены, когда будет получен новый ответ, а в строке состояния будет отображаться счетчик, пока ваши запросы обрабатываются.

Когда сбор завершится, в строке состояния появится зеленая галочка перед вашим путем .json
, а ваши файлы высказываний будут заполнены возможными ответами.

{
"collected": true,
"lines": [
{
"ask": "turn lights on",
"answers": [
"OK, turning 2 lights on.",
"Sure, turning on 2 lights.",
"Sure, turning 2 lights on.",
"Got it, turning 2 lights on.",
"Alright, turning on 2 lights.",
"OK, turning on 2 lights.",
"Got it, turning on 2 lights.",
"Alright, turning 2 lights on."
]
}
]
}
Если вы остановите сбор досрочно, ваш путь .json
не будет помечен как собранный.
Тестовая партия высказываний
После того, как вы соберете свои ответы, нажмите Assistant Simulator ожидает ответы, которые сохраняются в вашем файле JSON. Если ваш тест возвращает ответ, который не был собран, вы получите уведомление, похожее на следующий ответ:
Test , чтобы воспроизвести ваши запросы и проверить ваши ответы и журналы. Когда вы тестируете пакетные высказывания, Expected one of: "Got it, turning on 2 lights."

Этот сценарий указывает на неудачный тест. В противном случае Assistant Simulator будет выполнять каждый из ваших запросов и возвращать ответ. Если проверка прошла успешно, в строке состояния отображается галочка

Просмотр облачного ведения журнала
Чтобы открыть вкладку проекта в окне инструментов Cloud Logs, щелкните Cloud Logs на панели Google Home Plugin . Вы можете открывать отдельные вкладки Cloud Log для каждого из ваших проектов.

Условия запроса
Для выбранного проекта вы также можете фильтровать журналы с помощью поля «Запрос» . Например, чтобы отфильтровать журналы по ключевому слову light
:

Выберите «Использовать QL» , чтобы использовать язык запросов ведения журнала .

Вот несколько примеров QL-запросов, которые помогут вам начать работу:
severity = (DEBUG OR INFO OR NOTICE OR WARNING OR ERROR OR CRITICAL OR ALERT OR EMERGENCY) AND resource.type="assistant_action_project" AND timestamp > "2022-04-07T00:40:18Z"
jsonPayload.executionLog.executionResults.actionResults.action.trait = "TRAIT_ON_OFF"
jsonPayload.executionLog.executionResults.actionResults.action.actionType = "ONOFF_ON"
Запросы даты и времени
Запрос журналов по дате также необязателен, и его можно включить, щелкнув После и До . Вы можете ввести дату и время в соответствующем текстовом поле, например 5/11/22, 12:37 PM
, или использовать для выбора даты, а затем ввести время в текстовое поле.
- Чтобы выбрать дату после
5/1/22
, выберите « После» и щелкните значок даты . - Чтобы выбрать дату до
5/1/22
, выберите До и щелкните значок даты . - Чтобы выбрать дату между
5/1/22
и6/30/22
, выберите «До » и « После » и выберите даты на значке даты .
Выберите «В режиме реального времени» , чтобы получать журналы проекта в реальном времени. Нажмите «Стоп» , чтобы завершить трансляцию в реальном времени.
Уровень опасности
Вы также можете выбрать минимальную серьезность из раскрывающегося списка.
Результаты запроса
Щелкните
выбор , чтобы отправить параметры запроса.После загрузки журналов щелкните любую запись
, чтобы развернуть полную полезную нагрузку JSON. Щелкните еще раз чтобы отобразить полное сообщение. При желании вы можете ввести ключевое слово в поле «Фильтр» , чтобы сузить результаты журнала. Нажмите x
, чтобы удалить фильтр и вернуться к исходным результатам выборки.

Просмотр домашнего графика и запуск тестов
Чтобы получить список своих устройств, выберите Home Graph на панели Google Home Plugin .
Нажмите Обновить Google Home Graph для отдельных проектов.
, чтобы отобразить имя устройства , идентификатор устройства и тип устройства для ваших устройств, связанных с выбранным проектом. Вы можете открыть несколько панелейПосле загрузки устройств щелкните любую запись
, чтобы развернуть полную полезную нагрузку JSON.
Вы также можете использовать Развернуть и Свернуть , чтобы отобразить и скрыть полезные данные JSON для ваших устройств.

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

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

Средство просмотра журнала Android Debug Bridge (adb)
Чтобы открыть вкладку проекта в окне инструмента Adb Log, нажмите команду Adb Log на панели инструментов плагина Google Home (слева). Вы можете открыть отдельные вкладки журнала Adb для каждого из ваших файлов журнала. Чтобы удалить вкладку, щелкните значок
.Используйте поле «Выбрать» , чтобы выбрать конкретный компонент ведения журнала для просмотра, и раскрывающийся список «Серьезность» , чтобы отображать только записи с соответствующей серьезностью журнала.
Для выбранного журнала adb вы можете фильтровать записи журнала, используя поле «Фильтр» с необязательными модификаторами с учетом регистра или регулярных выражений.
Кроме того, вы можете:
- Найдите определенные записи, используя поле «Найти» и команды «Найти далее » (значок ) и «Найти предыдущий» (значок « »).
- Используйте необязательные модификаторы с учетом регистра или регулярных выражений .
- Перейти к строке , чтобы перейти к указанной строке (по номеру) в журнале.
Выберите «Пронумерованный» , чтобы просмотреть строки журнала с добавленными номерами строк. Выберите «Необработанный» , чтобы просмотреть необработанные записи журнала.

Ресурсы и отзывы
Щелкните Ресурсы , чтобы просмотреть список инструментов и ресурсов разработчика.
Чтобы поделиться своими мыслями или отзывами о том, как мы можем улучшить процесс разработки с помощью Google Home Plugin , нажмите «Отзыв» .
