Schemat cechy LightEffects dla inteligentnego domu
action.devices.traits.LightEffects
– ta cecha należy do urządzeń, które mogą obsługiwać złożone polecenia oświetlenia w celu zmiany stanu, np. wyświetlania różnych kolorów w pętli.
ATRYBUTY URZĄDZENIA
Urządzenia z tą cechą mogą zgłaszać te atrybuty w ramach operacji SYNC
. Więcej informacji o obsługiwaniu intencji SYNC
znajdziesz w artykule Realizacja intencji.
Atrybuty | Typ | Opis |
---|---|---|
defaultColorLoopDuration |
Liczba całkowita |
(wartość domyślna: Domyślny czas trwania efektu wywołanego poleceniem |
defaultSleepDuration |
Liczba całkowita |
(wartość domyślna: Domyślny czas trwania (w sekundach) efektu wywoływanego przez polecenie |
defaultWakeDuration |
Liczba całkowita |
(wartość domyślna: Domyślny czas trwania efektu wywołanego poleceniem |
supportedEffects |
Tablica |
Wymagany. Lista efektów obsługiwanych przez urządzenie. |
[item, ...] |
String |
Obsługiwany efekt. Obsługiwane wartości:
|
Przykłady
Urządzenie obsługujące efekt pętli kolorów.
{ "supportedEffects": [ "colorLoop" ] }
Urządzenie obsługujące efekty snu i budzenia.
{ "defaultSleepDuration": 300, "defaultWakeDuration": 600, "supportedEffects": [ "sleep", "wake" ] }
Urządzenie STATES
Elementy z tą cechą mogą raportować te stany w ramach operacji QUERY
. Więcej informacji o obsługiwaniu intencji QUERY
znajdziesz w artykule Realizacja intencji.
Stany | Typ | Opis |
---|---|---|
activeLightEffect |
String |
aktualnie aktywny efekt świetlny (jeśli występuje). Obsługiwane wartości:
|
lightEffectEndUnixTimestampSec |
Liczba całkowita |
Sygnatura czasowa uniksowego momentu, kiedy efekt powinien się zakończyć, jeśli efekt ustąpi samoistnie. |
Przykłady
Jaki jest obecny efekt na moim urządzeniu?
{ "activeLightEffect": "colorLoop" }
Jaki jest obecny wpływ na moje urządzenie?
{ "activeLightEffect": "sleep", "lightEffectEndUnixTimestampSec": 1595286869 }
Brak aktywnego efektu świetlnego.
{}
Polecenia na urządzeniu
Urządzenia z tą cechą mogą odpowiadać na te polecenia w ramach operacji EXECUTE
. Więcej informacji o obsługiwaniu intencji EXECUTE
znajdziesz w artykule Realizacja intencji.
action.devices.commands.ColorLoop
Poproś urządzenie o przełączanie się między zestawem kolorów.
To polecenie wymaga podania tych atrybutów:{ "supportedEffects": [ "colorLoop" ] }
Parametry
Parametry | Typ | Opis |
---|---|---|
duration |
Liczba całkowita |
Czas trwania polecenia pętli kolorów (w sekundach). |
Przykłady
Kolorowe światła przez 60 minut
{ "command": "action.devices.commands.ColorLoop", "params": { "duration": 3600 } }
action.devices.commands.Sleep
stopniowo zmniejsza jasność urządzenia i opcjonalnie dostosowuje temperaturę kolorów w ciągu określonego czasu.
To polecenie wymaga podania tych atrybutów:{ "supportedEffects": [ "sleep" ] }
Parametry
Parametry | Typ | Opis |
---|---|---|
duration |
Liczba całkowita |
Czas trwania polecenia uśpienia w sekundach. |
Przykłady
Wyłącz światło na 60 minut.
{ "command": "action.devices.commands.Sleep", "params": { "duration": 3600 } }
action.devices.commands.StopEffect
Zatrzymanie bieżącego efektu świetlnego.
Parametry
Parametry | Typ | Opis |
---|---|---|
Brak właściwości |
Przykłady
Zatrzymaj efekt na moim świetle.
{ "command": "action.devices.commands.StopEffect", "params": {} }
action.devices.commands.Wake
stopniowo zwiększa jasność urządzenia i opcjonalnie dostosowuje temperaturę kolorów w ciągu określonego czasu;
To polecenie wymaga podania tych atrybutów:{ "supportedEffects": [ "wake" ] }
Parametry
Parametry | Typ | Opis |
---|---|---|
duration |
Liczba całkowita |
Czas trwania polecenia aktywacji (w sekundach). |
Przykłady
Ustaw moje światła tak, aby były włączone przez 60 minut
{ "command": "action.devices.commands.Wake", "params": { "duration": 3600 } }
Emulacja efektów świetlnych
Jeśli Twoje urządzenie obsługuje cechę
Brightness
, ale nie cechę
LightEffects
, platforma obsługuje emulowane efekty „uśpienia” i „budzenia” bez konieczności dodawania dodatkowego kodu.
Platforma emuluje efekty, wysyłając serię intencji EXECUTE.
Przykładowe wypowiedzi
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