Esquema de rasgo de escena en casa inteligente

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

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

Por ejemplo, si un dispositivo permite que los usuarios configuren 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 mediante SYNC como una escena llamada, y Asistente pondrá esas 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 lograr una desambiguación:

  • Hora de festejar en la cocina
  • Activa el modo de luz nocturna en las habitaciones.

Una diferencia entre las escenas y los objetivos físicos es que Asistente aplicará automáticamente efectos plurales a los comandos de Ambiente, lo que permitirá que los usuarios activen escenas con varios socios. Por ejemplo, si un usuario tiene una escena de "modo fiesta" 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 la gramática personalizada (por ejemplo, Activate Party Mode -> ¡Que comience la fiesta!).

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

Dispositivo ATTRIBUTES

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 los intents SYNC, consulta Entrega de intents.

Atributos Tipo Descripción
sceneReversible Booleano

(Predeterminado: false)

Indica que esta escena se puede cancelar. 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 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 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.

Es verdadero para cancelar una escena si es reversible y 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
  }
}

ERRORS de dispositivos

Consulta la lista completa de errores y excepciones.