Плагин Google Home для Android Studio

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

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.

Плагин Google Home для Android Studio

Уведомление о безопасности

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

  1. Нажмите Файл , затем Настройки... .
  2. В разделе «Внешний вид и поведение» разверните «Системные настройки» и нажмите «Пароли» .
  3. Выберите Не сохранять, забыть пароли после перезагрузки.
Плагин Google Home для 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."

Протестируйте с помощью 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 в браузере.

Установить

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

  1. Загрузите или обновите Android Studio . Android Studio - Chipmunk (2021.2.1)+ to use the plugin. To learn more, refer to the Compatibility Range Download Android Studio
  2. Перейдите в меню «Файл» > «Настройки» ( Android Studio > «Настройки» в MacOS).
  3. В разделе «Плагины» перейдите в Marketplace и найдите google home .
  4. Установите инструмент и перезапустите Android Studio .
Вы также можете загрузить подключаемый модуль непосредственно с JetBrains Marketplace .

Настраивать

После установки плагина вам необходимо выполнить следующие шаги, прежде чем вы сможете использовать Assistant Simulator и просматривать облачное ведение журнала:

Войти через Google

Вы можете войти в свою учетную запись разработчика с панели Google Home, разрешив Android Studio взаимодействовать со службами Google от вашего имени.

  1. Щелкните вкладку Google Home в столбце вертикальной вкладки в левой части окна Android Studio .

  2. Для входа с помощью нажмите Google , чтобы запустить браузер.

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

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

  5. Закройте окно браузера и вернитесь в Android Studio .

Теперь вы должны войти в систему с возможностью выхода .

Выберите облачный проект

После входа в систему выберите проект из раскрывающегося списка. Чтобы отфильтровать список проектов, введите выражение фильтра , например, matter , затем нажмите Enter .

В раскрывающемся списке Project загружаются первые 100 проектов на основе вашего фильтра . Ваш выбор сохраняется при выходе из Android Studio .

Выберите проект

Справку по фильтрам проектов см. в разделе Параметры запроса в Google Cloud Reference.

Используйте симулятор помощника

Чтобы открыть Assistant Simulator в Android Studio , нажмите «Панель высказываний» на панели Google Home Plugin .

Открыть панель высказываний

Существует несколько способов отправки запросов в Assistant Simulator . Далее мы рассмотрим каждый вариант.

Введите запросы и соберите ответы

Чтобы взаимодействовать с Assistant Simulator , введите запрос и нажмите Enter.

Вы можете повторно отправить запрос, щелкнув значок повторной отправки в конце запроса.

После отправки одного или нескольких запросов нажмите повтор , чтобы повторно выполнить запросы и проверить свои ответы. Панель «Высказывания» отслеживает ваши запросы и ответы в сохраненном кеше. Воспроизведение только добавляет новые ответы в этот внутренний кэш и не будет дублировать ваши запросы каждый раз, когда вы нажимаете кнопку.

Воспроизведение высказываний с помощью Assistant Simulator

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

Собирайте высказывания с помощью Assistant Simulator

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

Собирайте высказывания с помощью Assistant Simulator
{
  "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

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

Запуск высказываний с помощью 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

Вы также можете использовать Развернуть и Свернуть , чтобы отобразить и скрыть полезные данные JSON для ваших устройств.

Главная График Развернуть и свернуть JSON

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

Главная График Прогон тестов

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

Главная График Завершенные тесты

Ресурсы и отзывы

Щелкните Ресурсы , чтобы просмотреть список инструментов и ресурсов разработчика.

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

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