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.