Добро пожаловать в Центр разработчиков Google Home, новое место, где можно научиться разрабатывать действия для умного дома. Примечание. Вы продолжите создавать действия в консоли действий.

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

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

SDK устройства

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

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

Чтобы использовать 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 со своей учетной записью.

Войти

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

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

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

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

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

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

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

  • Список устройств показывает все ваши виртуальные устройства. Вы можете выбрать определенное виртуальное устройство, чтобы просмотреть информацию о нем и создать виртуальные устройства через эту панель.
  • Информация об устройстве представляет информацию о выбранном виртуальном устройстве. Вы также можете отредактировать эту информацию и удалить выбранное виртуальное устройство через панель.
  • В области журнала отображаются журналы взаимодействия между 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.

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

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

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

Экспорт виртуальных устройств в файл

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

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

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

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

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

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

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

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

Обратная связь и сообщения о проблемах

Мы бы хотели получить от Вас отзывы! Дайте нам отзыв , нажав на значок смайлика « чувство_удовлетворено » в правом верхнем углу, или сообщите о возникших проблемах, используя значок с восклицательным знаком .

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