Schema del tratto Light Home di Smart Home
action.devices.traits.LightEffects
: questa caratteristica appartiene ai dispositivi che supportano comandi di illuminazione complessi per cambiare stato, ad esempio in loop tra vari colori.
ATTRIBUTE dispositivo
I dispositivi con questo trattino potrebbero segnalare i seguenti
attributi come parte dell'operazione SYNC
. Per saperne di più sulla gestione degli intent SYNC
, consulta la sezione fulfillment di 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 |
Array |
Obbligatorio. Elenco degli effetti supportati dal dispositivo. |
[item, ...] |
Stringa |
Effetto supportato. Valori supportati:
|
Esempi
Dispositivo che supporta l'effetto loop di colori.
{ "supportedEffects": [ "colorLoop" ] }
Dispositivo che supporta gli effetti sonno/veglia.
{ "defaultSleepDuration": 300, "defaultWakeDuration": 600, "supportedEffects": [ "sleep", "wake" ] }
STATO dispositivo
Le entità con questa caratteristica possono segnalare i seguenti
stati nell'ambito dell'operazione QUERY
, Per saperne di più sulla gestione degli intent QUERY
, consulta la sezione fulfillment di intent.
Stati | Tipo | Descrizione |
---|---|---|
activeLightEffect |
Stringa |
Effetto luce attualmente attivo, se presente. Una tra Valori supportati:
|
lightEffectEndUnixTimestampSec |
Intero |
Timestamp Unix quando è previsto che l'effetto termini da solo, se l'effetto termina da solo. |
Esempi
Qual è l'effetto attuale sul mio dispositivo?
{ "activeLightEffect": "colorLoop" }
Qual è l'effetto attuale sul mio dispositivo?
{ "activeLightEffect": "sleep", "lightEffectEndUnixTimestampSec": 1595286869 }
Nessun effetto luce attualmente attivo.
{}
COMANDI dispositivo
I dispositivi con questo trattino potrebbero rispondere ai seguenti
comandi nell'ambito dell'operazione EXECUTE
. Per saperne di più sulla gestione degli intent EXECUTE
, consulta la sezione fulfillment di intent.
action.devices.commands.ColorLoop
Richiedere al dispositivo di scorrere una serie di colori.
Questo comando richiede i seguenti attributi:{ "supportedEffects": [ "colorLoop" ] }
Parametri
Parametri | Tipo | Descrizione |
---|---|---|
duration |
Intero |
Durata del comando del loop di colori, espressa in secondi. |
Esempi
Applica colori alle mie 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 del 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 addormentare le luci per 60 minuti.
{ "command": "action.devices.commands.Sleep", "params": { "duration": 3600 } }
action.devices.commands.StopEffect
Interrompi l'effetto luce corrente.
Parametri
Parametri | Tipo | Descrizione |
---|---|---|
Nessuna proprietà |
Esempi
Interrompi l'effetto sulla luce.
{ "command": "action.devices.commands.StopEffect", "params": {} }
action.devices.commands.Wake
Aumenta gradualmente la luminosità del dispositivo e, se necessario, regola la temperatura del 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 attivazione, in secondi. |
Esempi
Fai svegliare le mie luci per 60 minuti.
{ "command": "action.devices.commands.Wake", "params": { "duration": 3600 } }
Emulazione effetti della luce
Se il tuo dispositivo implementa il tratto
Brightness
, ma non il tratto
LightEffects
,
la piattaforma supporta gli effetti emulati "sleep" e "wake", senza dover aggiungere altro codice.
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