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: 1800) Domyślny czas trwania efektu wywołanego przez polecenie action.devices.commands.ColorLoop (w sekundach).
defaultSleepDuration	Liczba całkowita	(Domyślnie: 1800) Domyślny czas trwania efektu wywołanego przez polecenie action.devices.commands.Sleep (w sekundach).
defaultWakeDuration	Liczba całkowita	(Domyślnie: 1800) Domyślny czas trwania efektu wywołanego przez polecenie action.devices.commands.Wake (w sekundach).
supportedEffects	Tablica	Wymagane. Lista efektów obsługiwanych przez urządzenie.
[item, ...]	String	Obsługiwany efekt. Obsługiwane wartości: colorLoop Pętla między różnymi kolorami. sleep Stopniowo zmniejsza jasność i opcjonalnie dostosowuje temperaturę kolorów w danym okresie. wake Stopniowo zwiększa jasność i opcjonalnie dostosowuje w danym okresie temperaturę kolorów.

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: supportedEffects. Obsługiwane wartości: colorLoop sleep wake
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

Urządzenie ERRORS

Zobacz pełną listę błędów i wyjątków.