Schema für Smart-Home-Lichteffekte
action.devices.traits.LightEffects
: Diese Eigenschaft gehört zu Geräten, die komplexe Beleuchtungsbefehle zum Ändern des Status unterstützen, wie z. B. Schleifen durch verschiedene Farben.
Geräte-ATTRIBUTES
Auf Geräten mit diesem Trait kann Folgendes gemeldet werden
im Rahmen des SYNC
-Vorgangs verwenden. Weitere Informationen
Weitere Informationen zum Umgang mit SYNC
-Intents finden Sie unter
Absichtliche Umsetzung.
Attribute | Typ | Beschreibung |
---|---|---|
defaultColorLoopDuration |
Ganzzahl |
(Standardeinstellung: Die Standarddauer in Sekunden für den Effekt, der durch den Befehl |
defaultSleepDuration |
Ganzzahl |
(Standardeinstellung: Die Standarddauer in Sekunden für den Effekt, der durch den Befehl |
defaultWakeDuration |
Ganzzahl |
(Standardeinstellung: 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
Gerät, das den Farbschleifeneffekt unterstützt.
{ "supportedEffects": [ "colorLoop" ] }
Gerät, das Schlaf-/Wach-Effekte unterstützt.
{ "defaultSleepDuration": 300, "defaultWakeDuration": 600, "supportedEffects": [ "sleep", "wake" ] }
Gerät: STATES
Entitäten mit diesem Merkmal melden möglicherweise Folgendes:
QUERY
-Bundesstaaten. Weitere Informationen
Weitere Informationen zum Umgang mit QUERY
-Intents finden Sie unter
Absichtliche Umsetzung.
Bundesstaaten | Typ | Beschreibung |
---|---|---|
activeLightEffect |
String |
Derzeit aktiver Lichteffekt, falls vorhanden. Eine von Unterstützte Werte:
|
lightEffectEndUnixTimestampSec |
Ganzzahl |
Unix-Zeitstempel, wenn der Effekt voraussichtlich endet, wenn der Effekt von selbst endet. |
Beispiele
Welche Auswirkungen hat das aktuell auf mein Gerät?
{ "activeLightEffect": "colorLoop" }
Welche Auswirkungen hat das aktuell auf mein Gerät?
{ "activeLightEffect": "sleep", "lightEffectEndUnixTimestampSec": 1595286869 }
Derzeit ist kein Lichteffekt aktiv.
{}
Gerät "COMMANDS"
Geräte mit diesem Merkmal können auf Folgendes reagieren
im Rahmen des EXECUTE
-Vorgangs ausgeführt. Weitere Informationen
Weitere Informationen zum Umgang mit EXECUTE
-Intents finden Sie unter
Absichtliche Umsetzung.
action.devices.commands.ColorLoop
Fordere das Gerät auf, eine Reihe von Farben durchzugehen.
Für diesen Befehl sind folgende Attribute erforderlich:{ "supportedEffects": [ "colorLoop" ] }
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
duration |
Ganzzahl |
Dauer für den Farbschleifenbefehl in Sekunden. |
Beispiele
Bewegen Sie meine Lampen 60 Minuten lang in einer Farbschleife.
{ "command": "action.devices.commands.ColorLoop", "params": { "duration": 3600 } }
action.devices.commands.Sleep
Verringern Sie nach und nach die Helligkeit des Geräts und passen Sie optional die Farbtemperatur über einen bestimmten Zeitraum an.
Für diesen Befehl sind folgende Attribute erforderlich:{ "supportedEffects": [ "sleep" ] }
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
duration |
Ganzzahl |
Dauer für den Ruhemodus-Befehl in Sekunden. |
Beispiele
Lass die Lampen 60 Minuten lang in den Ruhemodus wechseln.
{ "command": "action.devices.commands.Sleep", "params": { "duration": 3600 } }
action.devices.commands.StopEffect
Stoppe den aktuellen Lichteffekt.
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
Keine Attribute |
Beispiele
Beende den Effekt auf mein Licht.
{ "command": "action.devices.commands.StopEffect", "params": {} }
action.devices.commands.Wake
Erhöhen Sie nach und nach die Helligkeit des Geräts und passen Sie optional die Farbtemperatur innerhalb eines bestimmten Zeitraums an.
Für diesen Befehl sind folgende Attribute erforderlich:{ "supportedEffects": [ "wake" ] }
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
duration |
Ganzzahl |
Dauer für den Wake-Befehl in Sekunden. |
Beispiele
Stell mein Licht für 60 Minuten ein.
{ "command": "action.devices.commands.Wake", "params": { "duration": 3600 } }
Lichteffekt-Emulation
Wenn dein Gerät die
Brightness
-Eigenschaft, aber nicht
LightEffects
-Trait, die
Plattform unterstützt emulierte „Ruhemodus“ und „aufwachen“ Effekte anwenden, ohne zusätzlichen Code zu benötigen.
Die Plattform emuliert die Effekte, indem sie eine Reihe von EXECUTE-Intents sendet.
Beispieläußerungen
<ph type="x-smartling-placeholder">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