Намерения умного дома — это простые объекты обмена сообщениями, которые описывают, какое smart home Action to perform such as turn on a light or cast audio to a speaker.
Все намерения smart home содержатся в пространстве имен action.devices , и вы должны обеспечить их выполнение. Всякий раз, когда Google Assistant sends an intent to fulfillment, a user's third-party OAuth 2 access token is passed in the Authorization header.
Вот поддерживаемые намерения smart home :
СИНХРОНИЗАЦИЯ
Намерение action.devices.SYNC используется для запроса списка устройств smart home , которые пользователь подключил и которые доступны для использования.
Когда пользователь настраивает свои устройства с помощью Google Home app (GHA) , they also get authenticated to your cloud infrastructure. Then, Assistant receives an OAuth2 token. At this point, Assistant sends a action.devices.SYNC intent to your fulfillment to retrieve the initial list of user devices and capabilities from your cloud infrastructure.
Чтобы избежать отмены и повторной привязки аккаунта пользователя, вы можете отправить запрос на синхронизацию в Assistant . Это отправляет намерение action.devices.SYNC на ваше выполнение для синхронизации списка устройств и возможностей. Дополнительные сведения см. в разделе Реализация синхронизации запросов .
Во время настройки локального выполнения платформа Local Home проверяет ответ SYNC от облачного выполнения действия вашего smart home . Чтобы узнать больше о том, как изменить ответ SYNC для поддержки локального выполнения, см. раздел Обновление ответа SYNC в облаке .
ЗАПРОС
Намерение action.devices.QUERY используется для запроса текущего состояния устройств smart home .
Когда пользователи запрашивают статус устройства, чтобы ответить на такой вопрос, как «Окей, Google, какой свет горит на кухне?» , Assistant отправляет намерение action.devices.QUERY на ваше выполнение.
Для наилучшего взаимодействия с пользователем вам следует реализовать отчет о состоянии , чтобы заблаговременно сообщать о текущем состоянии устройств пользователя непосредственно в Google Home Graph . For example, this lets Assistant know if your user turned on a smart light with a physical light switch.
ВЫПОЛНЯТЬ
Намерение action.devices.EXECUTE используется для предоставления команд для выполнения на устройствах smart home .
Когда пользователи отправляют команды на устройства с помощью Assistant , ваше выполнение получает намерение action.devices.EXECUTE для вашего выполнения, которое описывает действие и устройства, на которые нужно воздействовать. Пользователь может выполнить действие на устройстве с помощью такой команды, как «Окей, Google, включи свет в моей гостиной» .
ОТКЛЮЧИТЬ
Намерение action.devices.DISCONNECT срабатывает, чтобы сообщить вам, когда пользователь отменил связь учетной записи приложения с Assistant . После получения намерения action.devices.DISCONNECT вы не должны сообщать о состоянии устройств этого пользователя.