Google Home Plugin for Android Studio is designed and created for Google Home Platform developers. This plugin gives you access to Google Assistant Simulator , Cloud Logging, and other tools to simplify your smart home development process.
Уведомление о безопасности
Чтобы запретить Android Studio хранить секреты и пароли, выполните следующие действия:
- Нажмите Файл , затем Настройки... .
- В разделе «Внешний вид и поведение» разверните «Системные настройки» и нажмите «Пароли» .
- Выберите Не сохранять, забыть пароли после перезагрузки.
Функции
Симулятор помощника
Чтобы проверить, правильно ли работают ваши умные домашние устройства с экосистемой Google Home, вы можете в любой момент взаимодействовать с Assistant Simulator , не выходя из Android Studio .
Подобно существующему симулятору помощника, представленному в Actions on Google Console Console, Assistant Simulator enables you to easily control your devices by typing your queries, for example, "Turn on the light." Inside Android Studio , Assistant Simulator responds back with text messages based on your commands, for example, "Alright, turning on the light."
Просмотр облачного ведения журнала
Google Cloud Logging предоставляет отладочную информацию и ключевые показатели, чтобы дать вам представление об использовании вашего действия. Чтобы упростить разработку, Google Home Plugin отображает сообщения Cloud Logging в реальном времени рядом с вашим кодом во время устранения неполадок.
Вы можете отображать журналы в реальном времени или выбирать диапазон дат.
Пакетные высказывания
Ответы Assistant Simulator на одно высказывание не являются детерминированными. Например, ответом может быть любая из следующих фраз:
- Понял, включил 2 лампочки.
- Конечно, включив 2 лампочки.
- Понял, загорелись 2 лампочки.
- Хорошо, включаю 2 лампочки.
Чтобы запустить автоматические тесты и проверить, как ваши интеграции Google работают с этими различными ответами, вы можете отправить пакетные высказывания в Assistant Simulator , запустив сценарии высказываний. После сохранения сценария вы можете собирать ответы и запускать несколько тестов по своим запросам.
Домашний просмотрщик графиков
Home Graph Viewer позволяет отображать состояние ваших устройств и запускать Google Home Test Suite в браузере.
Установить
Чтобы установить Google Home Plugin в Android Studio , выполните следующие действия:
- Загрузите или обновите Android Studio . Android Studio - Chipmunk (2021.2.1)+ to use the plugin. To learn more, refer to the Compatibility Range Download Android Studio
- Перейдите в меню «Файл» > «Настройки» ( Android Studio > «Настройки» в MacOS).
- В разделе «Плагины» перейдите в Marketplace и найдите
google home. - Установите инструмент и перезапустите Android Studio .
Настраивать
После установки плагина вам необходимо выполнить следующие шаги, прежде чем вы сможете использовать 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 не будет помечен как собранный.
Тестовая партия высказываний
После того, как вы соберете свои ответы, нажмите Test , чтобы воспроизвести ваши запросы и проверить ваши ответы и журналы. Когда вы тестируете пакетные высказывания, Assistant Simulator ожидает ответы, которые сохраняются в вашем файле JSON. Если ваш тест возвращает ответ, который не был собран, вы получите уведомление, похожее на следующий ответ:
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 panels open for separate projects.
После загрузки устройств щелкните любую запись , чтобы развернуть полную полезную нагрузку JSON.
Вы также можете использовать Развернуть и Свернуть , чтобы отобразить и скрыть полезные данные JSON для ваших устройств.
Чтобы запустить Test Suite для определенного устройства, нажмите Test . Это запустит Test Suite в вашем браузере с выбранным устройством, готовым к тестированию. Нажмите «Старт» и дождитесь результатов теста.
Вы можете проверить детали теста и просмотреть журналы после завершения тестов.
Ресурсы и отзывы
Щелкните Ресурсы , чтобы просмотреть список инструментов и ресурсов разработчика.
Чтобы поделиться своими мыслями или отзывами о том, как мы можем улучшить процесс разработки с помощью Google Home Plugin , нажмите «Отзыв» .
