Esquema de rasgos de LightEffects para casas inteligentes
action.devices.traits.LightEffects: Esta característica pertenece a dispositivos que pueden admitir comandos de iluminación complejos para cambiar el estado, como repetir indefinidamente varios colores.
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 |
|---|---|---|
defaultColorLoopDuration |
Número entero |
(Predeterminado: Es la duración predeterminada, en segundos, del efecto activado por el comando |
defaultSleepDuration |
Número entero |
(Predeterminado: Es la duración predeterminada, en segundos, del efecto activado por el comando |
defaultWakeDuration |
Número entero |
(Predeterminado: Es la duración predeterminada, en segundos, del efecto activado por el comando |
supportedEffects |
Matriz |
Obligatorio. Lista de efectos que admite el dispositivo. |
[item, ...] |
String |
Efecto compatible. Valores admitidos:
|
Ejemplos
Dispositivo compatible con efecto de bucle de color.
{
"supportedEffects": [
"colorLoop"
]
}
Dispositivo compatible con efectos de sueño y 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 controlar los intents QUERY, consulta Entrega de intents.
| Estados | Tipo | Descripción |
|---|---|---|
activeLightEffect |
String |
Efecto de luz activo actualmente, si corresponde. Es uno de Valores admitidos:
|
lightEffectEndUnixTimestampSec |
Número entero |
Marca de tiempo Unix en la que se espera que el efecto termine, si el efecto termina por sí solo. |
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.
{}
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.ColorLoop
Solicita al dispositivo que navegue por un conjunto de colores.
Este comando requiere los siguientes atributos:
{
"supportedEffects": [
"colorLoop"
]
}
Parámetros
| Parámetros | Tipo | Descripción |
|---|---|---|
duration |
Número entero |
Es la duración del comando de bucle de colores, en segundos. |
Ejemplos
Realiza un bucle de colores en las luces durante 60 minutos.
{
"command": "action.devices.commands.ColorLoop",
"params": {
"duration": 3600
}
}
action.devices.commands.Sleep
Disminuye gradualmente el brillo del dispositivo y, de manera opcional, ajusta la temperatura de color durante cierto período.
Este comando requiere los siguientes atributos:
{
"supportedEffects": [
"sleep"
]
}
Parámetros
| Parámetros | Tipo | Descripción |
|---|---|---|
duration |
Número entero |
Es la 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 cierto período.
Este comando requiere los siguientes atributos:
{
"supportedEffects": [
"wake"
]
}
Parámetros
| Parámetros | Tipo | Descripción |
|---|---|---|
duration |
Número entero |
Es la duración del comando de activación, en segundos. |
Ejemplos
Haz 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 de "suspensión" y "activación", sin necesidad de código adicional.
La plataforma emula los efectos enviando 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