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: 1800) Die Standarddauer in Sekunden für den Effekt, der durch den Befehl action.devices.commands.ColorLoop ausgelöst wird.
defaultSleepDuration	Ganzzahl	(Standardeinstellung: 1800) Die Standarddauer in Sekunden für den Effekt, der durch den Befehl action.devices.commands.Sleep ausgelöst wird.
defaultWakeDuration	Ganzzahl	(Standardeinstellung: 1800) Die Standarddauer in Sekunden für den Effekt, der durch den Befehl action.devices.commands.Wake ausgelöst wird.
supportedEffects	Array	Erforderlich. Liste der vom Gerät unterstützten Effekte.
[item, ...]	String	Unterstützter Effekt. Unterstützte Werte: colorLoop Durchläuft verschiedene Farben zufällig. sleep Die Helligkeit wird schrittweise verringert und optional die Farbtemperatur über einen bestimmten Zeitraum angepasst. wake Die Helligkeit wird schrittweise erhöht und optional die Farbtemperatur über einen bestimmten Zeitraum angepasst.

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 supportedEffects. Unterstützte Werte: colorLoop sleep wake
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

Gerätefehler

Vollständige Liste der Fehler und Ausnahmen.