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.
Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Esquema de la característica de escena del hogar inteligente

action.devices.traits.Scene: Esta característica se usa para implementar dispositivos virtuales junto con el tipo de dispositivo ESCENA.

Para obtener más información, consulta la Guía sobre tipos de escenas.

Por ejemplo, si un dispositivo permite a los usuarios configurar la agrupación de comandos con un toque (configurar luces en colores específicos, secuenciar varias funciones de seguridad o cualquier otra combinación de actividades), esta configuración se puede exponer a través de SYNC como una escena con nombre y el Asistente pondrá estas escenas a disposición de los usuarios mediante una gramática de activación simple:

  • Inicia el modo Fiesta.
  • Activa la escena de medianoche.

Como objetos virtuales, las escenas se pueden colocar en salas (si es relevante) para su desambiguación:

  • Inicia una fiesta en la cocina.
  • Activa el modo de luz nocturna en las habitaciones.

Una diferencia entre las escenas y los objetivos físicos es que el Asistente aplicará automáticamente los efectos plurales a los comandos de Escena, lo que permite a los usuarios activar escenas en varios socios. Por ejemplo, si un usuario tiene una escena de "modo de fiesta" en dos socios diferentes, uno por seguridad y otro por luces, el modo de activación de fiesta activará ambos.

Las escenas interactuarán bien con las acciones personales futuras para la gramática personalizada (por ejemplo, Activar modo Fiesta -> ¡Que empiece la fiesta!).

Las escenas siempre deben tener nombres que proporcione el usuario en lugar de nombres predeterminados de “BobCo Scene”. Cada escena es un dispositivo virtual propio con sus propios nombres. Los nombres proporcionados por los usuarios pueden provenir de SYNC.

ATTRIBUTES del dispositivo

Los dispositivos con esta característica pueden informar los siguientes atributos como parte de la operación SYNC. Para obtener más información sobre el manejo de intents SYNC, consulta Entrega de intents.

Atributos Tipo Descripción
sceneReversible Booleano

(Predeterminado: false)

Indica que se puede cancelar esta escena. Este atributo solo es relevante para escenas que modifican el estado y recuerdan el anterior. El dispositivo admite el comando ActivateScene con el parámetro deactivate como verdadero.

Ejemplos

Dispositivo compatible con una escena reversible.

{
  "sceneReversible": true
}

Dispositivo STATEs

Ninguno

Dispositivo COMMANDS

Los dispositivos con esta característica pueden responder a los siguientes comandos como parte de la operación EXECUTE. Para obtener más información sobre el manejo de intents EXECUTE, consulta Entrega de intents.

action.devices.commands.ActivateScene

Activar o desactivar una escena

Parámetros

Parámetros Tipo Descripción
deactivate Booleano

Obligatorio.

Verdadero para cancelar una escena si es reversible. Falso para activar una escena.

Ejemplos

Activa una escena por su nombre.

{
  "command": "action.devices.commands.ActivateScene",
  "params": {
    "deactivate": false
  }
}

Desactiva una escena por nombre.

{
  "command": "action.devices.commands.ActivateScene",
  "params": {
    "deactivate": true
  }
}

Dispositivo ERRORS

Consulta la lista completa de errores y excepciones.