Los intents de casa inteligente son objetos de mensajería simples que describen qué Cloud-to-cloud integración se debe realizar, como encender una luz o transmitir audio a una bocina.
Todos los intents de smart home se encuentran en el
action.devices espacio de nombres, y debes proporcionar una entrega para ellos. Cada vez que
Google Assistant envía un intent a la entrega, se pasa el token de acceso de OAuth 2 de terceros de un usuario
en el encabezado Autorización.
Estos son los intents smart home compatibles:
SYNC
El intent action.devices.SYNC se usa para solicitar la lista de
smart home dispositivos que el usuario conectó y que están
disponibles para su uso.
Cuando un usuario configura sus dispositivos con la Google Home app (GHA), también
se autentica en tu infraestructura de la nube. Luego,
Assistant recibe un token de OAuth2. En este punto,
Assistant envía un intent action.devices.SYNC a tu
entrega para recuperar la lista inicial de dispositivos y capacidades del usuario de
tu infraestructura de la nube.
Para evitar desvincular y volver a vincular la cuenta de un usuario, puedes enviar una sincronización de solicitud
a Assistant. Esto envía el intent action.devices.SYNC a tu entrega para sincronizar la lista de dispositivos y capacidades. Consulta
Implementa la sincronización de solicitudes para obtener más
información.
Durante la configuración de la entrega local, la
plataforma de Local Home verifica la respuesta SYNC de la entrega en la nube de tu
smart home Acción. Para obtener más información sobre cómo
modificar tu respuesta SYNC para admitir la entrega local, consulta
Actualiza la respuesta SYNC en la entrega en la nube.
QUERY
El intent action.devices.QUERY se usa para consultar el estado actual
de los dispositivos smart home.
Cuando los usuarios consultan el estado del dispositivo, para responder una pregunta como
Hey Google, ¿qué luces están encendidas en la cocina?,
Assistant envía un intent action.devices.QUERY a tu
entrega.
Para brindar la mejor experiencia del usuario, debes implementar Report State para informar de forma proactiva el estado actual de los dispositivos de un usuario directamente a Google Home Graph. Por ejemplo, esto le permite Assistant saber si el usuario encendió una lámpara inteligente con un interruptor de luz físico.
EXECUTE
El intent action.devices.EXECUTE se usa para proporcionar comandos
que se ejecutarán en dispositivos smart home.
Cuando los usuarios envían comandos a dispositivos con Assistant, tu
entrega recibe un intent action.devices.EXECUTE que
describe la acción y los dispositivos en los que se debe actuar. Un usuario puede ejecutar una acción en un dispositivo con un comando como Hey Google, enciende las luces de mi sala de estar.
DISCONNECT
Se activa el intent action.devices.DISCONNECT para informarte
cuando un usuario desvinculó la cuenta de la app de Assistant.
Después de recibir un intent action.devices.DISCONNECT, no debes informar el estado de los dispositivos de este usuario.