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

Домашняя игровая площадка 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 . Щелкните Редактор ответа на синхронизацию , чтобы открыть встроенную среду IDE.

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

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

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

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

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

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

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

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

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

  1. Нажмите , чтобы импортировать виртуальные устройства из файла.
  2. Выберите файл, который хотите импортировать, и нажмите OK .
  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.