Actividades

Los intents de casa inteligente son objetos de mensajería simples que describen qué acción smart home realizar, como encender una luz o transmitir audio a una bocina.

Todos los intents smart home se encuentran en el espacio de nombres action.devices y debes proporcionar entregas 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 de autorización.

Estos son los intents smart home admitidos:

SINCRONIZAR

El intent action.devices.SYNC se usa a fin de 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 el Google Home app (GHA), también se autentica 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 entrega para recuperar la lista inicial de dispositivos de los usuarios y las capacidades de tu infraestructura de nube.

En esta figura, se muestra la interacción entre la infraestructura de Google y la de socios. Desde la infraestructura de Google, hay una lista de socios disponibles para la app cliente de Asistente, que luego fluye a la infraestructura de socios a fin de completar la autenticación de OAuth. La autenticación de OAuth del lado del socio es la vista web de configuración de socios, la vista web de OAuth, las condiciones y los términos de configuración opcionales, y los servicios en la nube del socio. Luego, la infraestructura del socio envía las credenciales de OAuth a la app cliente del Asistente. Los servicios en la nube del socio envían dispositivos y capacidades disponibles a los servicios del Asistente, que luego almacenan la información en el gráfico de inicio.
Figura 1: Interacción entre Google y la infraestructura del socio

Para evitar la desvinculación y la revinculación de la cuenta de un usuario, puedes enviar una solicitud de sincronización a Assistant. Esto envía el intent action.devices.SYNC a la entrega para sincronizar la lista de dispositivos y capacidades. Consulta Cómo implementar solicitudes de sincronización para obtener más información.

Diagrama de flujo de un intent de SYNC
Figura 2: Intents de SYNC

Durante la configuración de la entrega local, la plataforma local local verifica la respuesta SYNC de la entrega en la nube de tu acción de smart home. Si quieres obtener más información para modificar tu respuesta de SYNC a fin de 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 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.

Diagrama de flujo de un intent QUERY
Figura 3: Intención de QUERY

Para obtener la mejor experiencia del usuario, debes implementar el informe de estado a fin de informar de forma proactiva sobre el estado actual de los dispositivos de un usuario directamente a Google Home Graph. Por ejemplo, esto permite que Assistant sepa si tu usuario activó una lámpara inteligente con un interruptor físico.

Cómo informar el estado del dispositivo con el estado de informes
Figura 4: Informa el estado del dispositivo

EJECUTAR

El intent action.devices.EXECUTE se usa para proporcionar comandos que se ejecutan en dispositivos smart home.

Cuando los usuarios envían comandos a dispositivos con Assistant, la entrega recibe un intent action.devices.EXECUTE a la entrega 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.

Diagrama de flujo de un intent EXECUTE
Figura 5: Intención DE EJECUTAR

DESCONECTAR

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