Los intents de casa inteligente son objetos de mensajería simples que describen qué acción de smart home realizar, como encender una luz o transmitir audio a una bocina.
Todos los intents smart home se encuentran en la
action.devices y debes proporcionarles una entrega. Siempre
Google Assistant envía un intent a la entrega, el nombre de
el token de acceso de OAuth 2 de terceros se pasa en el encabezado de autorización.
Estos son los intents smart home admitidos:
SINCRONIZAR
El intent action.devices.SYNC se usa para solicitar la lista de
smart home dispositivos que el usuario conectó y que
disponibles para su uso.
Cuando un usuario configura sus dispositivos con Google Home app (GHA), también
se autentiquen en la infraestructura de nube. Luego,
Assistant recibe un token de OAuth2. En este punto,
Assistant envía un intent action.devices.SYNC a tu
de entrega para recuperar la lista inicial de dispositivos y capacidades del usuario
tu infraestructura de nube.
Para evitar desvincular y volver a vincular la cuenta de un usuario, puedes enviar una solicitud de sincronización
a Assistant. Esto envía el intent action.devices.SYNC
con tu entrega para sincronizar la lista de dispositivos y capacidades. Consulta
Implementa la sincronización de solicitudes para obtener más información
información.
Durante la configuración de la entrega local, la
La plataforma de Local Home verifica la respuesta de SYNC de tu
smart home Entrega en la nube de la acción. Para obtener más información sobre cómo
Si quieres modificar tu respuesta de SYNC para admitir la entrega local, consulta
Actualiza la respuesta de SYNC en la entrega en la nube.
CONSULTA
El intent action.devices.QUERY se usa para consultar el estado actual
de smart home dispositivos.
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
la entrega de datos.
Para obtener la mejor experiencia del usuario, deberías implementar Estado de la denuncia para informar de forma proactiva el estado actual de los dispositivos de un usuario directamente Google Home Graph Por ejemplo, esto permite Assistant saber si tu usuario encendió una lámpara inteligente con una interruptor de luz físico.
EJECUTAR
El intent action.devices.EXECUTE se usa para proporcionar comandos
se ejecutará en dispositivos smart home.
Cuando los usuarios envían comandos a los dispositivos con Assistant, tu
de entrega recibe un intent action.devices.EXECUTE que
describe la acción y los dispositivos sobre los que actuar. 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
Se activa el intent action.devices.DISCONNECT para informarte
Cuando un usuario desvincula la cuenta de la app de Assistant.
Después de recibir un intent action.devices.DISCONNECT, no debes informar
para los dispositivos de este usuario.