Google Home Playground

Облако-облако    Local Home SDK    Home API

Google Home Playground – это веб-приложение, которое имитирует проект умного дома с настраиваемыми типами устройств и характеристиками. Вы можете создавать виртуальные устройства, изменять их атрибуты и состояния, просматривать их в Google Home Graph, а также импортировать и экспортировать конфигурации устройств.

Как завершить привязку аккаунта

Чтобы использовать Google Home Playground, сначала свяжите инструмент со своим аккаунтом. Откройте приложение Google Home app (GHA) на телефоне и выполните процесс связывания аккаунтов, описанный в статье Как подключить стороннее устройство умного дома в приложении Google Home.

  1. Найдите интеграцию Google Home Playground.
  2. Выберите интеграцию, и GHA перенаправит вас на страницу входа. Нажмите Войти с аккаунтом Google и выберите аккаунт.
  3. Нажмите кнопку Авторизовать, чтобы разрешить связывание аккаунтов.
На рисунке ниже показан процесс привязки аккаунта в приложении Google Home для подключения Google Home Playground.

После того как вы свяжете аккаунт, в приложении "GHA" появится набор виртуальных устройств по умолчанию, с которыми можно взаимодействовать.

На рисунке показан список устройств, который появляется, когда пользователь успешно связывает Google Home Playground со своим аккаунтом.

Войти

Запустите Google Home Playground, нажав кнопку ниже.

Запустить Playground

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

На рисунке показано начальное состояние Google Home Playground и выделена кнопка входа в правом верхнем углу.

После входа в аккаунт в Google Home Playground будут показаны виртуальные устройства, хранящиеся в Home Graph.

На рисунке показан список устройств, информация об устройстве и область журнала в представлении по умолчанию в Google Home Playground.

Веб-интерфейс состоит из трех панелей:

  • Список устройств содержит все ваши виртуальные устройства. Вы можете выбрать виртуальное устройство, чтобы посмотреть информацию о нем, а также создать виртуальные устройства на этой панели.
  • В разделе Информация об устройстве представлена информация о выбранном виртуальном устройстве. Вы также можете изменить эту информацию и удалить выбранное виртуальное устройство с помощью панели.
  • В журнале регистрируются взаимодействия между Google Home Playground и Home Graph. Вы можете развернуть журналы, чтобы проверить полезную нагрузку запросов и ответов и устранить неполадки.

Виртуальное устройство

Как посмотреть информацию о виртуальном устройстве

На панели Список устройств выберите виртуальное устройство, которое хотите посмотреть. На панели Список устройств выберите виртуальное устройство, которое хотите посмотреть. На панели Информация об устройстве данные будут разделены на пять вкладок:

  • Основная информация: свойства устройства верхнего уровня, в том числе тип, идентификатор и название устройства.
  • Типажи. Поддерживаемые типажи устройства.
  • Атрибуты – атрибуты устройства, относящиеся к определенному признаку.
  • Состояния: все состояния устройств.
  • Дополнительная верификация пользователя – конфигурация дополнительной верификации пользователя на устройстве.

Как изменить информацию о виртуальном устройстве

Помимо просмотра информации о виртуальном устройстве, вы также можете напрямую редактировать его данные, хранящиеся в Home Graph, с помощью панели Информация об устройстве.

Как изменить поддерживаемые traits

  1. Откройте вкладку Характеристики и нажмите кнопку Изменить.
  2. На всплывающей панели можно посмотреть, какие traits поддерживаются устройством в данный момент и какие можно добавить. Используйте стрелки (arrow_forward/arrow_back), чтобы добавить или удалить поддерживаемые характеристики устройства.
  3. Когда вы измените все поддерживаемые функции, нажмите Сохранить. Обновленные функции будут применены к Home Graph.
  4. Информацию об этих изменениях можно найти в журнале.
На этом изображении показан инструмент UX, с помощью которого можно добавлять или удалять поддерживаемые характеристики на выбранном устройстве в Google Home Playground.

Как изменить атрибуты устройства

  1. Перейдите на вкладку Атрибуты и измените атрибут для функций, поддерживаемых устройством.
  2. Завершив редактирование, нажмите Ввод. Изменения будут применены к Home Graph.
  3. Обновленные атрибуты можно посмотреть в Журнале.

Изменение состояний устройств

  1. Откройте вкладку Статусы и измените статус. Изменения статуса будут применены к Home Graph.
  2. Эти изменения можно посмотреть в журнале.

Как добавить дополнительную проверку пользователя на виртуальное устройство

Вы можете добавить дополнительную верификацию пользователя в виртуальные устройства и настроить тип запроса и соответствующее поведение на каждом устройстве. Вы можете добавить дополнительную верификацию пользователя в виртуальные устройства и настроить тип задания и соответствующее поведение на каждом устройстве.

Как настроить SUV на устройстве

  1. На панели Список устройств выберите виртуальное устройство, которое хотите настроить.
  2. На панели Информация об устройстве выберите вкладку Внедорожник и настройте следующие параметры:
    • Включено: включена или отключена функция SUV (без запроса) на устройстве.
    • Тип запроса. Требуется ли явное подтверждение (ackNeeded) или персональный идентификационный номер (pinNeeded).
    • PIN-код: действительный PIN-код.
    • Обработка неверного PIN-кода. Если PIN-код введен неправильно, нужно ли запрашивать его снова и, если нет, какую ошибку возвращать.
На этом рисунке показан инструмент UX, позволяющий включить признаки дополнительной проверки пользователя на выбранном устройстве в Google Home Playground.

Как определить устройства, на которых можно включить SUV

На панели Список устройств рядом с каждым устройством, для которого включена функция SUV, отображается значок ключа key.

На этом рисунке показаны устройства, для которых рекомендуется включить дополнительную проверку пользователя.

Для следующих характеристик требуется SUV:

Как создать новое виртуальное устройство

  1. На панели Список устройств нажмите Добавить устройство.
  2. На всплывающей панели выберите тип устройства и введите его название. Также можно выбрать набор устройств из списка.
  3. После того как вы выполните все шаги, новое устройство будет добавлено вHome Graph.
На этом рисунке показан инструмент добавления нового типа устройства в Google Home Playground.

Как удалить виртуальное устройство

  1. На панели Список устройств выберите устройство, которое хотите удалить. Затем на панели Информация об устройстве выберите вкладку Основная информация и внизу нажмите Значок корзиныУдалить устройство.
  2. Подтвердите удаление устройства во всплывающем окне.
  3. После подтверждения устройство будет удалено из Home Graph.
На рисунке показан инструмент удаления виртуального типа устройства в Google Home Playground.

Редактор ответов синхронизации

Вы можете проверить или изменить ответ на запрос синхронизации в Google Home Playground. Нажмите Редактор ответов синхронизации, чтобы открыть встроенную интегрированную среду разработки.

На рисунке показана кнопка, с помощью которой можно открыть редактор ответа на запрос синхронизации.

Отредактируйте или скопируйте и вставьте ответ синхронизации и нажмите Сохранить, чтобы применить изменения и посмотреть, как это работает в экосистеме Google Home.

На этом рисунке показано окно для редактирования ответа на запрос синхронизации.

Как импортировать и экспортировать виртуальные устройства

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

На этом рисунке показан инструмент импорта и экспорта виртуальных устройств в Google Home Playground.

Как экспортировать виртуальные устройства в файл

  1. Нажмите , чтобы экспортировать виртуальные устройства в файл.
  2. Введите название файла, который хотите экспортировать, и нажмите ОК.
  3. После того как вы введете название файла, браузер скачает файл экспортированных виртуальных устройств.

Как импортировать виртуальные устройства из файла

  1. Нажмите , чтобы импортировать виртуальные устройства из файла.
  2. Выберите файл, который хотите импортировать, и нажмите ОК.
  3. После того как вы подтвердите файл для импорта, Google Home Playground импортирует виртуальные устройства с состояниями из файла и обновит информацию и состояния импортированных устройств в Home Graph.

Проверка журналов взаимодействий

Когда вы взаимодействуете с виртуальными устройствами, Google Home Playgroundавтоматически применяет изменения к Home Graph. Взаимодействия с Home Graph записываются на панели Область журнала, где можно развернуть каждую запись, чтобы проверить полезную нагрузку запроса к API Home Graph и ответа.

Каждая запись в журнале представляет собой массив JSON, содержащий элементы следующей структуры:

{
  "uri": string,
  "request": object,
  "response": object
}
Поля Тип Описание
uri string URL вызова API Home Graph.
request object Тело запроса вызова API Home Graph. Формат каждого метода описан в справочной документации справочной документации.
response object Тело ответа на вызов API Home Graph. Формат каждого метода описан в справочной документации справочной документации.

Как посмотреть поддерживаемые типы устройств и traits

Нажмите на значок вопроса Справка в правом верхнем углу, чтобы посмотреть текущий тип устройства и список функций, поддерживаемых Google Home Playground.

На этом рисунке показан инструмент добавления нового типа устройства в Google Home Playground.

Как сообщить о проблеме

Мы будем благодарны вам за отзыв. Сообщить о проблеме можно, нажав на значок восклицательного знака Отправить отзыв в правом верхнем углу.

На этом изображении показаны значки для отправки отзывов и сообщений о проблемах в Google Home Playground.