Интенты умного дома — это простые объекты сообщений, описывающие, какие действия в рамках интеграции Cloud-to-cloud необходимо выполнить, например, включить свет или передать звук на динамик.
Все намерения smart home находятся в пространстве имен action.devices , и вам необходимо обеспечить их выполнение. Всякий раз, когда Google Assistant отправляет намерение в функцию выполнения, в заголовке Authorization передается сторонний токен доступа OAuth 2 пользователя.
Вот список поддерживаемых намерений smart home :
SYNC
Интент action.devices.SYNC используется для запроса списка устройств smart home , которые пользователь подключил и которые доступны для использования.
Когда пользователь настраивает свои устройства с помощью Google Home app (GHA) , он также проходит аутентификацию в вашей облачной инфраструктуре. Затем Assistant получает токен OAuth2. На этом этапе Assistant отправляет намерение action.devices.SYNC в вашу систему обработки запросов, чтобы получить первоначальный список пользовательских устройств и их возможностей из вашей облачной инфраструктуры.
Чтобы избежать отвязки и повторной привязки учетной записи пользователя, вы можете отправить запрос на синхронизацию в Assistant . Это отправит намерение action.devices.SYNC в вашу систему обработки запросов для синхронизации списка устройств и возможностей. Дополнительную информацию см. в разделе «Реализация запроса на синхронизацию» .
В процессе настройки локального выполнения платформа «Локальный дом» проверяет ответ SYNC от облачного сервиса выполнения действий вашего smart home . Чтобы узнать больше о том, как изменить ответ SYNC для поддержки локального выполнения, см. раздел «Обновление ответа SYNC в облачном сервисе выполнения» .
ЗАПРОС
Интент action.devices.QUERY используется для запроса текущего состояния устройств smart home .
Когда пользователи запрашивают информацию о состоянии устройства, например , «Привет, Google, какие лампы горят на кухне?» , Assistant отправляет намерение action.devices.QUERY в ваш обработчик запросов.
Для обеспечения наилучшего пользовательского опыта следует внедрить функцию «Отчет о состоянии» , которая будет заблаговременно сообщать о текущем состоянии устройств пользователя непосредственно в Google Home Graph . Например, это позволит Assistant узнать, включил ли пользователь умный светильник с помощью физического выключателя.
ВЫПОЛНЯТЬ
Интент action.devices.EXECUTE используется для предоставления команд, которые необходимо выполнить на устройствах smart home .
Когда пользователи отправляют команды устройствам с помощью Assistant , ваш запрос на выполнение получает интент action.devices.EXECUTE , описывающий действие и устройства, на которые нужно воздействовать. Пользователь может выполнить действие на устройстве с помощью команды, например: «Привет, Google, включи свет в моей гостиной» .
ОТКЛЮЧИТЬ
Интент action.devices.DISCONNECT срабатывает, чтобы сообщить вам, когда пользователь отвязал учетную запись приложения от Assistant . После получения интента action.devices.DISCONNECT вам не следует сообщать о состоянии устройств этого пользователя.