Esquema de atributos de escenas de casa inteligente

action.devices.traits.Scene: Este atributo se usa para implementar dispositivos virtuales junto con el tipo de dispositivo SCENE.

Consulta la guía de tipos de escenas para obtener más información.

Por ejemplo, si un dispositivo permite a los usuarios configurar la agrupación de comandos con un solo toque (configurar luces con 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 nombrada, y el Asistente pondrá estas escenas a disposición de los usuarios a través de una gramática de activación simple:

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

Como objetos virtuales, las escenas se pueden colocar en habitaciones (si corresponde) para la resolución de ambigüedades:

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

Una diferencia entre las escenas y los destinos físicos es que el Asistente aplicará automáticamente efectos en plural a los comandos de escena, lo que permitirá a los usuarios activar escenas en varios socios. Por ejemplo, si un usuario tiene una escena de "modo fiesta" en dos socios diferentes, uno para la seguridad y otro para las luces, Activar modo fiesta activará ambos.

Las escenas interactuarán bien con las próximas Acciones personales para la gramática personalizada (por ejemplo, Activate Party Mode -> Let's get the party started!).

Las escenas siempre deben tener nombres proporcionados por el usuario en lugar de nombres predeterminados como "Escena de BobCo". Cada escena es su propio dispositivo virtual, con sus propios nombres. Los nombres que proporciona el usuario pueden provenir de SYNC.

ATRIBUTOS 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 cómo controlar intents SYNC, consulta Cómo entregar intents.

Atributos Tipo Descripción
sceneReversible Booleano

(Predeterminado: false)

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

Ejemplos

Dispositivo que admite una escena reversible.

{
  "sceneReversible": true
}

ESTADOS DEL DISPOSITIVO

Ninguno

COMANDOS del dispositivo

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 cómo controlar intents EXECUTE, consulta Cómo entregar intents.

action.devices.commands.ActivateScene

Activar o desactivar una escena

Parámetros

Parámetros Tipo Descripción
deactivate Booleano

Obligatorio.

Es verdadero para cancelar una escena si es reversible y falso para activarla.

Ejemplos

Activa una escena por nombre.

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

Desactiva una escena por nombre.

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

ERRORES del dispositivo

Consulta la lista completa de errores y excepciones.