Schema dei tratti degli effetti di luce per la smart home
action.devices.traits.LightEffects
. Questa caratteristica appartiene ai dispositivi in grado di supportare comandi di illuminazione complessi per cambiare stato, ad esempio riprodurre in loop vari colori.
ATTRIBUTES del dispositivo
I dispositivi con questo trait potrebbero segnalare i seguenti attributi nell'ambito dell'operazione SYNC
. Per scoprire di più sulla gestione degli intent SYNC
, consulta fulfillment dell'intent.
Attributi | Tipo | Descrizione |
---|---|---|
defaultColorLoopDuration |
Intero |
(Valore predefinito: La durata predefinita, in secondi, dell'effetto attivato dal comando |
defaultSleepDuration |
Intero |
(Valore predefinito: La durata predefinita, in secondi, dell'effetto attivato dal comando |
defaultWakeDuration |
Intero |
(Valore predefinito: La durata predefinita, in secondi, dell'effetto attivato dal comando |
supportedEffects |
Matrice |
Obbligatorio. Elenco degli effetti supportati dal dispositivo. |
[item, ...] |
String |
Effetto supportato. Valori supportati:
|
Esempi
Dispositivo che supporta l'effetto loop di colori.
{ "supportedEffects": [ "colorLoop" ] }
Dispositivo che supporta gli effetti di sonno/veglia.
{ "defaultSleepDuration": 300, "defaultWakeDuration": 600, "supportedEffects": [ "sleep", "wake" ] }
Dispositivo STATES
Le entità con questo trait possono segnalare i seguenti
stati nell'ambito dell'operazione QUERY
. Per scoprire di più sulla gestione degli intent QUERY
, consulta fulfillment dell'intent.
Stati | Tipo | Descrizione |
---|---|---|
activeLightEffect |
String |
Effetto della luce attualmente attivo, se presente. Uno di Valori supportati:
|
lightEffectEndUnixTimestampSec |
Intero |
Timestamp Unix del punto in cui è previsto il termine dell'effetto, se quest'ultimo termina automaticamente. |
Esempi
Qual è l'effetto corrente sul mio dispositivo?
{ "activeLightEffect": "colorLoop" }
Qual è l'effetto corrente sul mio dispositivo?
{ "activeLightEffect": "sleep", "lightEffectEndUnixTimestampSec": 1595286869 }
Nessun effetto luce attualmente attivo.
{}
COMMANDS dispositivo
I dispositivi con questa caratteristica potrebbero rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE
. Per scoprire di più sulla gestione degli intent EXECUTE
, consulta fulfillment dell'intent.
action.devices.commands.ColorLoop
Richiedi al dispositivo di scorrere tra una serie di colori.
Questo comando richiede i seguenti attributi:{ "supportedEffects": [ "colorLoop" ] }
Parametri
Parametri | Tipo | Descrizione |
---|---|---|
duration |
Intero |
Durata del comando color loop, in secondi. |
Esempi
Esegui il colorloop delle luci per 60 minuti.
{ "command": "action.devices.commands.ColorLoop", "params": { "duration": 3600 } }
action.devices.commands.Sleep
Abbassa gradualmente la luminosità del dispositivo e, facoltativamente, regola la temperatura di colore per un determinato periodo di tempo.
Questo comando richiede i seguenti attributi:{ "supportedEffects": [ "sleep" ] }
Parametri
Parametri | Tipo | Descrizione |
---|---|---|
duration |
Intero |
Durata del comando di sospensione, in secondi. |
Esempi
Fai dormire le luci per 60 minuti.
{ "command": "action.devices.commands.Sleep", "params": { "duration": 3600 } }
action.devices.commands.StopEffect
Interrompi l'effetto di luce corrente.
Parametri
Parametri | Tipo | Descrizione |
---|---|---|
Nessuna proprietà |
Esempi
Interrompi l'effetto sulla mia luce.
{ "command": "action.devices.commands.StopEffect", "params": {} }
action.devices.commands.Wake
Aumenta gradualmente la luminosità del dispositivo e, facoltativamente, regola la temperatura di colore per un determinato periodo di tempo.
Questo comando richiede i seguenti attributi:{ "supportedEffects": [ "wake" ] }
Parametri
Parametri | Tipo | Descrizione |
---|---|---|
duration |
Intero |
Durata del comando di riattivazione, in secondi. |
Esempi
Fai in modo che le luci si attivino per 60 minuti.
{ "command": "action.devices.commands.Wake", "params": { "duration": 3600 } }
Emulazione di effetti di luce
Se il tuo dispositivo implementa il tratto
Brightness
ma non il trait
LightEffects
, la
piattaforma supporta gli effetti emulati "sospeso" e "risveglio", senza la necessità di codice aggiuntivo.
La piattaforma emula gli effetti inviando una serie di intent EXECUTE.
Espressioni di esempio
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