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

API-интерфейсы локального домашнего SDK для взаимодействия между облаками

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 , нажав кнопку ниже:

Площадка для запуска

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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