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

Локальный домашний SDK для взаимодействия между облаками Home API

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

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

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

1. Найдите интеграцию под названием Google Home Playground .
2. Выберите интеграцию, и GHA направит вас на страницу входа. Нажмите Sign in with Google и выберите свою учетную запись для входа.
3. Нажмите кнопку «Авторизовать» , чтобы разрешить привязку аккаунта.

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

Войти

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

Запуск игровой площадки

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• Поставить на охрану
• ЗаблокироватьРазблокировать
• ОткрытьЗакрыть
• Перезагрузить
• Обновление ПО

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Когда вы взаимодействуете с виртуальными устройствами, Google Home Playground автоматически применяет ваши изменения к Home Graph . Взаимодействия с Home Graph записываются на панель области журнала , где вы можете развернуть каждую запись, чтобы проверить полезные нагрузки запросов и ответов API Home Graph .

Каждая запись журнала представляет собой массив JSON, содержащий элементы следующей структуры:

{
  "uri": string,
  "request": object,
  "response": object
}

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

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

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

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