Te damos la bienvenida al Centro para desarrolladores de Google Home, el nuevo destino para aprender a desarrollar acciones para el hogar inteligente. Nota: Continuarás compilando acciones en la Consola de Actions.

Actividades

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Los intents de casa inteligente son objetos de mensajería simples que describen lo que smart home Action to perform such as turn on a light or cast audio to a speaker.

Todos los intents smart home se encuentran en el espacio de nombres action.devices y debes proporcionarlos para ellos. Siempre Google Assistant sends an intent to fulfillment, a user's third-party OAuth 2 access token is passed in the Authorization header.

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 en los que están disponibles.

Cuando un usuario configura sus dispositivos con el 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.

En esta figura, se muestra la interacción entre la infraestructura de Google y la infraestructura del socio. Desde la infraestructura de Google, hay una lista de socios disponibles para la app cliente de Asistente, que, luego, fluye a la infraestructura del socio a fin de completar la autenticación de OAuth. La autenticación de OAuth del lado del socio es la configuración web, la vista web de OAuth, las condiciones y los parámetros de configuración opcionales del socio, y los servicios en la nube del socio. Luego, la infraestructura del socio muestra 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 Home Graph.
Figura 1: Interacción entre Google y la infraestructura de socios

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 a tu entrega para sincronizar la lista de dispositivos y capacidades. Consulta Cómo implementar la solicitud de sincronización para obtener más información.

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

Durante la configuración de la entrega local, la plataforma de Local Home verifica la respuesta SYNC de la entrega de Cloud de tu acción smart home. Si deseas obtener más información sobre cómo modificar tu respuesta de SYNC para que admita 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: Intent de QUERY

Para obtener la mejor experiencia del usuario, implementa el estado del informe a fin de informar directamente el estado actual de los dispositivos de un usuario a Google Home Graph. For example, this lets Assistant know if your user turned on a smart light with a physical light switch..

Cómo informar el estado del dispositivo con el estado del informe
Figura 4: Informar 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, tu entrega recibe un intent action.devices.EXECUTE en tu entrega que describe la acción y los dispositivos en los que debe 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.

Diagrama de flujo de un intent EXECUTE
Figura 5: Intento EXECUTE

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 action.devices.DISCONNECT, no debes informar el estado de los dispositivos de este usuario.