Домашняя игровая площадка 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.