Schema von LightEffects für Smart Homes
action.devices.traits.LightEffects
: Diese Trait gehört zu Geräten, die komplexe Beleuchtungsbefehle zum Ändern des Zustands unterstützen, z. B. Schleifen durch verschiedene Farben.
Geräte-ATTRIBUTE
Geräte mit dieser Eigenschaft melden möglicherweise die folgenden Attribute im Rahmen des SYNC
-Vorgangs. Weitere Informationen zum Umgang mit SYNC
-Intents finden Sie unter Intent-Auftragsausführung.
Attribute | Typ | Beschreibung |
---|---|---|
defaultColorLoopDuration |
Ganzzahl |
(Standard: Die Standarddauer in Sekunden für den Effekt, der durch den Befehl |
defaultSleepDuration |
Ganzzahl |
(Standard: Die Standarddauer in Sekunden für den Effekt, der durch den Befehl |
defaultWakeDuration |
Ganzzahl |
(Standard: Die Standarddauer in Sekunden für den Effekt, der durch den Befehl |
supportedEffects |
Array |
Erforderlich. Liste der vom Gerät unterstützten Effekte. |
[item, ...] |
String |
Unterstützter Effekt. Unterstützte Werte:
|
Beispiele
Das Gerät unterstützt den Farbschleifeneffekt.
{ "supportedEffects": [ "colorLoop" ] }
Gerät, das Schlaf-/Wach-Effekte unterstützt
{ "defaultSleepDuration": 300, "defaultWakeDuration": 600, "supportedEffects": [ "sleep", "wake" ] }
Gerät STATES
Entitäten mit diesem Trait können die folgenden Status im Rahmen des QUERY
-Vorgangs melden. Weitere Informationen zum Umgang mit QUERY
-Intents finden Sie unter Intent-Auftragsausführung.
Bundesstaaten | Typ | Beschreibung |
---|---|---|
activeLightEffect |
String |
Aktuell aktiver Lichteffekt, falls vorhanden. Eine von Unterstützte Werte:
|
lightEffectEndUnixTimestampSec |
Ganzzahl |
Unix-Zeitstempel, wann der Effekt voraussichtlich enden wird, falls er von selbst endet |
Beispiele
Welche Auswirkungen hat das aktuell auf meinem Gerät?
{ "activeLightEffect": "colorLoop" }
Welche Auswirkungen hat das aktuell auf meinem Gerät?
{ "activeLightEffect": "sleep", "lightEffectEndUnixTimestampSec": 1595286869 }
Momentan ist kein Lichteffekt aktiv.
{}
BEFEHLUNGEN auf dem Gerät
Geräte mit dieser Eigenschaft können im Rahmen des EXECUTE
-Vorgangs auf die folgenden Befehle reagieren. Weitere Informationen zum Umgang mit EXECUTE
-Intents finden Sie unter Intent-Auftragsausführung.
action.devices.commands.ColorLoop
Fordere das Gerät an, durch eine Reihe von Farben zu wechseln.
Für diesen Befehl sind die folgenden Attribute erforderlich:{ "supportedEffects": [ "colorLoop" ] }
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
duration |
Ganzzahl |
Dauer des Farbschleifenbefehls in Sekunden. |
Beispiele
Eine Farbschleife der Beleuchtung für 60 Minuten
{ "command": "action.devices.commands.ColorLoop", "params": { "duration": 3600 } }
action.devices.commands.Sleep
Die Helligkeit des Geräts wird allmählich verringert und optional die Farbtemperatur über einen bestimmten Zeitraum angepasst.
Für diesen Befehl sind die folgenden Attribute erforderlich:{ "supportedEffects": [ "sleep" ] }
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
duration |
Ganzzahl |
Dauer des Ruhemodus-Befehls in Sekunden. |
Beispiele
Lass meine Lampen 60 Minuten lang schlafen.
{ "command": "action.devices.commands.Sleep", "params": { "duration": 3600 } }
action.devices.commands.StopEffect
Aktuellen Lichteffekt stoppen.
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
Keine Attribute |
Beispiele
Beende den Effekt auf die Lampe.
{ "command": "action.devices.commands.StopEffect", "params": {} }
action.devices.commands.Wake
Die Helligkeit des Geräts wird allmählich erhöht und optional die Farbtemperatur über einen bestimmten Zeitraum angepasst.
Für diesen Befehl sind die folgenden Attribute erforderlich:{ "supportedEffects": [ "wake" ] }
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
duration |
Ganzzahl |
Dauer des Aktivierungsbefehls in Sekunden. |
Beispiele
Stell meine Lampen für 60 Minuten aufwach.
{ "command": "action.devices.commands.Wake", "params": { "duration": 3600 } }
Lichteffekte-Emulation
Wenn dein Gerät die Trait
Brightness
implementiert, aber nicht die Trait LightEffects
, unterstützt die Plattform emulierte Schlaf- und Wacheffekte, ohne dass zusätzlicher Code erforderlich ist.
Die Plattform emuliert die Effekte, indem sie eine Reihe von EXECUTE-Intents sendet.
Beispieläußerungen
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