Esquema de la función SmartEffects de Home Home
action.devices.traits.LightEffects
: Esta característica pertenece a los dispositivos que admiten comandos de iluminación complejos para cambiar el estado, como repetir indefinidamente 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 cómo manejar los 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
Efecto de bucle de colores compatible con el dispositivo.
{ "supportedEffects": [ "colorLoop" ] }
Dispositivo que admite efectos de suspensión/activación.
{ "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 cómo manejar los intents QUERY
, consulta Entrega de intents.
Estados | Tipo | Descripción |
---|---|---|
activeLightEffect |
String |
Efecto de luz activo actualmente (si lo hay). Valores admitidos:
|
lightEffectEndUnixTimestampSec |
Número entero |
Es una marca de tiempo Unix en la que 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 COMMAND
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 manejar los 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
Colorear mis luces en bucle durante 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 de 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 en segundos del comando de activación. |
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 característica 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 noquarto dos miudos . -
Iniciar o modo dormir
por 1 hora nasluzes do quarto . -
Liga a função adormecer das
luzes .
sv-SE
-
Starta insomningsläge på
lamporna -
Tänd
lamporna långsamt