Schemat funkcji inteligentnych efektów świetlnych
action.devices.traits.LightEffects
– ta cecha należy do urządzeń, które obsługują złożone polecenia dotyczące oświetlenia i zmieniają stan oświetlenia, na przykład pętlenie różnych kolorów.
Urządzenie ATTRIBUTES
Urządzenia z tą cechą mogą zgłaszać poniższe atrybuty w ramach operacji SYNC
. Więcej informacji o obsłudze intencji SYNC
znajdziesz w artykule o realizacji intencji.
Atrybuty | Typ | Opis |
---|---|---|
defaultColorLoopDuration |
Liczba całkowita |
(Domyślnie: Domyślny czas trwania efektu wywołanego przez polecenie |
defaultSleepDuration |
Liczba całkowita |
(Domyślnie: Domyślny czas trwania efektu wywołanego przez polecenie |
defaultWakeDuration |
Liczba całkowita |
(Domyślnie: Domyślny czas trwania efektu wywołanego przez polecenie |
supportedEffects |
Tablica |
Wymagane. 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/wybudzania.
{ "defaultSleepDuration": 300, "defaultWakeDuration": 600, "supportedEffects": [ "sleep", "wake" ] }
Urządzenie STATES
Encje z tą cechą mogą zgłaszać poniższe stany w ramach operacji QUERY
. Więcej informacji o obsłudze intencji QUERY
znajdziesz w artykule o realizacji intencji.
Stany | Typ | Opis |
---|---|---|
activeLightEffect |
String |
Obecnie aktywny efekt świetlny (jeśli występuje). Jedno z tych: Obsługiwane wartości:
|
lightEffectEndUnixTimestampSec |
Liczba całkowita |
Sygnatura czasowa uniksowego zakończenia efektu, o ile efekt kończy się samoczynnie. |
Przykłady
Jaki jest obecnie efekt na moim urządzeniu?
{ "activeLightEffect": "colorLoop" }
Jaki jest obecnie efekt na moim urządzeniu?
{ "activeLightEffect": "sleep", "lightEffectEndUnixTimestampSec": 1595286869 }
Obecnie nie jest aktywny żaden efekt świetlny.
{}
CommandS na urządzeniu
Urządzenia z tą cechą mogą reagować na podane niżej polecenia w ramach operacji EXECUTE
. Więcej informacji o obsłudze intencji EXECUTE
znajdziesz w artykule o realizacji intencji.
action.devices.commands.ColorLoop
Urządzenie może przełączać się między różnymi kolorami.
To polecenie wymaga tych atrybutów:{ "supportedEffects": [ "colorLoop" ] }
Parametry
Parametry | Typ | Opis |
---|---|---|
duration |
Liczba całkowita |
Czas trwania polecenia pętli kolorów (w sekundach). |
Przykłady
Zapętlaj światło 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 danym okresie.
To polecenie wymaga tych atrybutów:{ "supportedEffects": [ "sleep" ] }
Parametry
Parametry | Typ | Opis |
---|---|---|
duration |
Liczba całkowita |
Czas trwania polecenia uśpienia w sekundach. |
Przykłady
Przelej żarówki w tryb uśpienia na 60 minut.
{ "command": "action.devices.commands.Sleep", "params": { "duration": 3600 } }
action.devices.commands.StopEffect
Wyłącz bieżący efekt świetlny.
Parametry
Parametry | Typ | Opis |
---|---|---|
Brak właściwości |
Przykłady
Nie wyłączaj światła.
{ "command": "action.devices.commands.StopEffect", "params": {} }
action.devices.commands.Wake
Stopniowo zwiększaj jasność na urządzeniu i opcjonalnie dostosowuje temperaturę kolorów w danym okresie.
To polecenie wymaga tych atrybutów:{ "supportedEffects": [ "wake" ] }
Parametry
Parametry | Typ | Opis |
---|---|---|
duration |
Liczba całkowita |
Czas trwania polecenia wybudzania (w sekundach). |
Przykłady
Ustaw światło na 60 minut.
{ "command": "action.devices.commands.Wake", "params": { "duration": 3600 } }
Emulacja efektów świetlnych
Jeśli Twoje urządzenie implementuje cechę
Brightness
, ale nie ma cechy LightEffects
, platforma obsługuje emulowane efekty „uśpienia” i „wybudzenia” bez konieczności pisania 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