Намерения умного дома — это простые объекты сообщений, которые описывают, какую интеграцию Cloud-to-cloud нужно выполнить, например включить свет или воспроизвести звук на динамике.
Все намерения smart home содержатся в пространстве имён action.devices , и для них необходимо обеспечить выполнение. Каждый раз, когда Google Assistant отправляет намерение на выполнение, в заголовке Authorization передаётся сторонний токен доступа OAuth 2 пользователя.
Поддерживаемые намерения smart home :
СИНХРОНИЗАЦИЯ
Намерение action.devices.SYNC используется для запроса списка устройств smart home , которые пользователь подключил и которые доступны для использования.
Когда пользователь настраивает свои устройства с помощью Google Home app (GHA) , он также проходит аутентификацию в вашей облачной инфраструктуре. Затем Assistant получает токен OAuth2. В этот момент Assistant отправляет вам намерение action.devices.SYNC , чтобы получить начальный список устройств и возможностей пользователя из вашей облачной инфраструктуры.
Чтобы избежать необходимости отсоединения и повторного присоединения учётной записи пользователя, вы можете отправить запрос на синхронизацию в Assistant . Это отправит намерение action.devices.SYNC в ваш сервис выполнения для синхронизации списка устройств и возможностей. Подробнее см. в разделе «Реализация запроса на синхронизацию» .
Во время настройки локального выполнения заказов платформа Local Home проверяет ответ 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 вам не следует сообщать о состоянии устройств этого пользователя.