Домашняя игровая площадка Google

SDK для локального домашнего устройства, перенос из облака в облако

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

Полная привязка аккаунта

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

  1. Нажмите значок плюса (+) в верхнем левом углу.
  2. Выберите «Настроить устройство» > «Работает с Google» .
  3. Найдите действие под названием Google Home Playground .
  4. Выберите Действие, и GHA направит вас на страницу входа. Нажмите «Войти через Google» и выберите свою учетную запись для входа.
  5. Нажмите кнопку «Авторизовать» , чтобы авторизовать привязку учетной записи.
На этом рисунке показан процесс привязки учетной записи приложения Google Home для подключения Google Home Playground.

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

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

Войти

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

Запустить игровую площадку

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

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

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

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

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

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

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

Просмотр информации о виртуальном устройстве

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

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

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

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

Изменить поддерживаемые черты

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

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

  1. Выберите вкладку «Атрибуты» и отредактируйте атрибут для характеристик, поддерживаемых устройством.
  2. Завершив редактирование, нажмите Enter , и изменения атрибутов будут применены к Home Graph .
  3. Вы можете просмотреть эти обновленные атрибуты в области журнала .

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

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

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

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

Настройте внедорожник на устройстве

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

Определите устройства, которые поддерживают внедорожник

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

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

Следующий список характеристик требует внедорожника:

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

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

Удаление виртуального устройства

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

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

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

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

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

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

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

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

На этом рисунке показан инструмент UX для импорта и экспорта виртуальных устройств в 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 . См. справочную документацию по формату каждого метода.

Просмотр поддерживаемых типов и характеристик устройств

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

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

Сообщить о проблемах

Мы бы хотели получить от Вас отзывы! Сообщите о возникших проблемах с помощью значка восклицательного знака в правом верхнем углу.

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