Берегись! Скоро будут запущены новые программы Developer Preview. Подайте заявку здесь и станьте одним из первых, кто опробует новые инструменты и оставит отзыв.

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

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

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

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

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

  1. Нажмите Файл , затем Настройки... .
  2. В разделе «Внешний вид и поведение» разверните «Системные настройки» и нажмите «Пароли» .
  3. Выберите Не сохранять, забыть пароли после перезагрузки.
Плагин Google Home для Android Studio

Функции

Симулятор помощника

Чтобы проверить, правильно ли работают ваши умные домашние устройства с экосистемой Google Home, вы можете в любой момент взаимодействовать с Assistant Simulator , не выходя из Android Studio .

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

Протестируйте с помощью 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 , выполните следующие действия:

  1. Загрузите или обновите Android Studio . Скачать Android-студию
  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 для отдельных проектов.

После загрузки устройств щелкните любую запись , чтобы развернуть полную полезную нагрузку JSON.

Главная График Полезная нагрузка JSON

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

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

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

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

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

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

Средство просмотра журнала Android Debug Bridge (adb)

Чтобы открыть вкладку проекта в окне инструмента Adb Log, нажмите команду Adb Log на панели инструментов плагина Google Home (слева). Вы можете открыть отдельные вкладки журнала Adb для каждого из ваших файлов журнала. Чтобы удалить вкладку, щелкните значок .

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

Для выбранного журнала adb вы можете фильтровать записи журнала, используя поле «Фильтр» с необязательными модификаторами с учетом регистра или регулярных выражений.

Кроме того, вы можете:

  • Найдите определенные записи, используя поле «Найти» и команды «Найти далее » (значок ) и «Найти предыдущий» (значок « »).
  • Используйте необязательные модификаторы с учетом регистра или регулярных выражений .
  • Перейти к строке , чтобы перейти к указанной строке (по номеру) в журнале.

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

Просмотр журнала Adb

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

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

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

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