Los intents para la casa inteligente son objetos de mensajería simples que describen qué integración de Cloud-to-cloud se debe realizar, como encender una luz o transmitir audio a una bocina.
Todas las acciones de smart home se encuentran en el espacio de nombres action.devices
, y debes proporcionar una respuesta para ellas. Cada vez que Google Assistant envía un intent a la función de cumplimiento, se pasa el token de acceso de OAuth 2 de terceros de un usuario en el encabezado de autorización.
Estos son los intents de smart home compatibles:
SINCRONIZAR
El intent action.devices.SYNC
se usa para solicitar la lista de dispositivos smart home que el usuario conectó y que están disponibles para su uso.
Cuando un usuario configura sus dispositivos con Google Home app (GHA), también se autentica en tu infraestructura de nube. Luego, Assistant recibe un token de OAuth2. En este punto, Assistant envía una intención action.devices.SYNC
a tu cumplimiento para recuperar la lista inicial de dispositivos y capacidades del usuario de tu infraestructura de nube.

Para evitar desvincular y volver a vincular la cuenta de un usuario, puedes enviar una sincronización de solicitudes a Assistant. Esto envía la intención action.devices.SYNC
a tu cumplimiento 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 acción smart home. Para obtener más información sobre cómo modificar tu respuesta SYNC
para admitir la entrega local, consulta Actualiza la respuesta de 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 de los dispositivos, 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 cumplimiento.

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 a Assistant saber si el usuario encendió una luz inteligente con un interruptor físico.

EJECUTAR
La intención 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
fulfillment recibe un intent action.devices.EXECUTE
que describe la acción y los dispositivos en los que se debe realizar la acción. Un usuario puede ejecutar una acción en un dispositivo con un comando como Hey Google, enciende las luces de la sala de estar.

DESCONECTAR
El intent action.devices.DISCONNECT
se activa para informarte cuando un usuario desvinculó la cuenta de la app de Assistant.
Después de recibir una intención action.devices.DISCONNECT
, no debes informar el estado de los dispositivos de este usuario.