Esquema de trait de la escena de la casa 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 de tipos de escenas.

Por ejemplo, si un dispositivo permite que los usuarios configuren la agrupación de un toque de configurar las luces en colores específicos o secuenciar varios comandos funciones o cualquier otra combinación de actividades, esta configuración puede se exponga a través de SYNC como una escena con nombre, y el Asistente las hará escenas disponibles para los usuarios a través de una gramática de activación simple:

  • Iniciar el modo Fiesta
  • Activa la escena nocturna.

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

  • Comienza la fiesta en la cocina
  • Activa el modo de luz nocturna en los dormitorios.

Una diferencia entre las escenas y los objetivos físicos es que el Asistente aplican automáticamente efectos plurales a los comandos de Scene, lo que permite que los usuarios activen con varios socios. Por ejemplo, si un usuario tiene un "modo Fiesta" escena en dos socios diferentes, uno para seguridad y otro para luces, activar modo Fiesta activará ambos.

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

Las escenas siempre deben tener nombres proporcionados por el usuario en comparación con la "Escena de BobCo" predeterminada de nombres. Cada escena es su propio dispositivo virtual, con su propio nombre. Los nombres proporcionados por el usuario pueden provenir de SYNC.

ATRIBUTOS DISPOSITIVOS

Los dispositivos con este trait pueden informar lo siguiente atributos como parte de la operación SYNC. Para aprender Para obtener más información sobre cómo controlar los 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 estado anterior. El dispositivo admite el comando ActivateScene con el parámetro deactivate como verdadero.

Ejemplos

Dispositivo que admite una escena reversible.

{
  "sceneReversible": true
}

Dispositivo STATES

Ninguno

COMANDOS del dispositivo

Los dispositivos con este rasgo pueden responder a lo siguiente comandos como parte de la operación EXECUTE. Para aprender Para obtener más información sobre cómo controlar los intents EXECUTE, consulta Entrega de intents.

action.devices.commands.ActivateScene

Activa o desactiva 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

Activar 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 DE DISPOSITIVO

Consulta la lista completa de errores y excepciones.