Esquema de rasgo de escena de casa inteligente
action.devices.traits.Scene
: Esta característica se usa para implementar dispositivos virtuales junto con el tipo de dispositivo "ESCUELA".
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 (es decir, establecer luces en colores específicos o 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 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 ubicar en salas (si es relevante) para lograr la desambiguación:
- Comienza a 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 en plural a los comandos de Escena, lo que les permite a los usuarios activar 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, la opción Activar el modo Fiesta activará ambas.
Las escenas interactuarán bien con las acciones personales futuras para tener una gramática personalizada (por ejemplo, Activar el modo Fiesta -> ¡Empecemos la fiesta!).
Las escenas siempre deben tener nombres proporcionados por el usuario en lugar de los nombres predeterminados "BobCo Scene". 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
. Si quieres obtener más información para controlar intents SYNC
, consulta Entrega de intents.
Atributos | Tipo | Descripción |
---|---|---|
sceneReversible |
Booleano |
(Predeterminado: 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 |
Ejemplos
Dispositivo que admite una escena reversible.
{ "sceneReversible": true }
Dispositivo STATES
Ningún contenido de este tipo
COMMANDS del dispositivo
Los dispositivos con esta característica pueden responder a los siguientes comandos como parte de la operación EXECUTE
. Si quieres obtener más información para controlar 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 nombre.
{ "command": "action.devices.commands.ActivateScene", "params": { "deactivate": false } }
Desactiva una escena por nombre.
{ "command": "action.devices.commands.ActivateScene", "params": { "deactivate": true } }