Esquema de la función LightEffects de Smart Home
action.devices.traits.LightEffects
: Esta característica pertenece a los dispositivos que admiten comandos de iluminación complejos para cambiar el estado, como la repetición indefinida de varios colores.
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 el manejo de intents SYNC
, consulta Entrega de intents.
Atributos | Tipo | Descripción |
---|---|---|
defaultColorLoopDuration |
Número entero |
(Predeterminado: Es la duración predeterminada (en segundos) del efecto que activa el comando |
defaultSleepDuration |
Número entero |
(Predeterminado: Es la duración predeterminada (en segundos) del efecto que activa el comando |
defaultWakeDuration |
Número entero |
(Predeterminado: Es la duración predeterminada (en segundos) del efecto que activa el comando |
supportedEffects |
Matriz |
Obligatorio. Lista de los efectos que admite el dispositivo. |
[item, ...] |
String |
Efecto admitido. Valores admitidos:
|
Ejemplos
Dispositivo que admite el efecto de bucle de color.
{ "supportedEffects": [ "colorLoop" ] }
Dispositivos que admiten efectos de activación y sueño.
{ "defaultSleepDuration": 300, "defaultWakeDuration": 600, "supportedEffects": [ "sleep", "wake" ] }
Dispositivo STATEs
Las entidades con esta característica pueden informar los siguientes estados como parte de la operación QUERY
. Para obtener más información sobre el manejo de intents QUERY
, consulta Entrega de intents.
Estados | Tipo | Descripción |
---|---|---|
activeLightEffect |
String |
Efecto de luz actualmente activo si corresponde. Uno de Valores admitidos:
|
lightEffectEndUnixTimestampSec |
Número entero |
Es la marca de tiempo de Unix cuando se espera que finalice el efecto, si este finaliza por su cuenta. |
Ejemplos
¿Cuál es el efecto actual en mi dispositivo?
{ "activeLightEffect": "colorLoop" }
¿Cuál es el efecto actual en mi dispositivo?
{ "activeLightEffect": "sleep", "lightEffectEndUnixTimestampSec": 1595286869 }
No hay ningún efecto de luz activo en este momento.
{}
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.ColorLoop
Solicita al dispositivo que recorra un conjunto de colores.
Este comando requiere los siguientes atributos:{ "supportedEffects": [ "colorLoop" ] }
Parámetros
Parámetros | Tipo | Descripción |
---|---|---|
duration |
Número entero |
Duración del comando de bucle de color, en segundos. |
Ejemplos
Uso de colores en mis luces por 60 minutos.
{ "command": "action.devices.commands.ColorLoop", "params": { "duration": 3600 } }
action.devices.commands.Sleep
Reduce gradualmente el brillo del dispositivo y, de manera opcional, ajusta la temperatura de color durante un período de tiempo.
Este comando requiere los siguientes atributos:{ "supportedEffects": [ "sleep" ] }
Parámetros
Parámetros | Tipo | Descripción |
---|---|---|
duration |
Número entero |
Duración del comando de suspensión, en segundos. |
Ejemplos
Hacer que las luces se suspendan durante 60 minutos
{ "command": "action.devices.commands.Sleep", "params": { "duration": 3600 } }
action.devices.commands.StopEffect
Detén el efecto de luz actual.
Parámetros
Parámetros | Tipo | Descripción |
---|---|---|
Sin propiedades |
Ejemplos
Detén el efecto en la luz.
{ "command": "action.devices.commands.StopEffect", "params": {} }
action.devices.commands.Wake
Aumenta gradualmente el brillo del dispositivo y, de manera opcional, ajusta la temperatura de color durante un período de tiempo.
Este comando requiere los siguientes atributos:{ "supportedEffects": [ "wake" ] }
Parámetros
Parámetros | Tipo | Descripción |
---|---|---|
duration |
Número entero |
Duración del comando de activación, en segundos. |
Ejemplos
Hacer que las luces se activen durante 60 minutos
{ "command": "action.devices.commands.Wake", "params": { "duration": 3600 } }
Emulación de efectos de luz
Si tu dispositivo implementa la característica
Brightness
, pero no la de LightEffects
, la plataforma admite los efectos emulados "sleep" y "wake", sin necesidad de código adicional.
La plataforma emula los efectos mediante el envío de una serie de intents EXECUTE.
Expresiones de muestra
de-DE
- Den Aufwacheffekt der Lampen starten.
- Einschlafmodus im Schlafzimmer aktivieren.
- synchronisiere meine Geräte
en-US
- Begin the sleep effect on my lights .
- I want you to start wake effect on the lights
es-ES
- pon la luz de despertarse lentamente durante 45 minutos
- pon las luces de dormir
fr-FR
- Allume doucement les lumières .
- Éteins progressivement les lumières .
hi-IN
- बेडरूम में धीरे-धीरे रोशनी बढ़ाओ
- लाइट को स्लीप मोड में डाल दो
it-IT
- Accendi le luci gradualmente
- Avvia le luci per dormire
ja-JP
- ライト を徐々に明るくなる設定にして
- 照明 を少しずつ暗くして
ko-KR
- 안방 전등 기상 모드 시작해
- 조명 에서 수면 모드 실행
nl-NL
- Dim de lichten langzaam.
- Laat mijn lamp langzaam feller worden.
pt-BR
- Acenda lentamente as luzes do quarto por 1 hora .
- Ativa as luzes de despertar no quarto dos miudos .
- Iniciar o modo dormir por 1 hora nas luzes do quarto .
- Liga a função adormecer das luzes .
sv-SE
- Starta insomningsläge på lamporna
- Tänd lamporna långsamt