Smart Home LightEffects Trait Schema

action.devices.traits.LightEffects: Dieses Attribut gehört zu Geräten, die komplexe Beleuchtungsbefehle zur Änderung des Status unterstützen, z. B. das Durchlaufen verschiedener Farben.

Geräteattribute

Geräte mit diesem Merkmal können die folgenden Attribute im Rahmen des Vorgangs SYNC melden. Weitere Informationen zur Verarbeitung von SYNC-Intents finden Sie unter Intent-Ausführung.

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ätestatus

Für Entitäten mit diesem Merkmal können im Rahmen des Vorgangs QUERY die folgenden Status gemeldet werden. Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Intent-Fulfillment.

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ÄTEBEFEHLE

Geräte mit diesem Merkmal reagieren möglicherweise auf die folgenden Befehle im Rahmen des Vorgangs EXECUTE. Weitere Informationen zur Verarbeitung von EXECUTE-Intents finden Sie unter Intent-Ausführung.

action.devices.commands.ColorLoop

Fordern Sie das Gerät auf, eine Reihe von Farben durchzugehen.

{
  "supportedEffects": [
    "colorLoop"
  ]
}

Parameter

Beispiele

Schalte meine Beleuchtung für 60 Minuten in den Farbwechselmodus.

{
  "command": "action.devices.commands.ColorLoop",
  "params": {
    "duration": 3600
  }
}

action.devices.commands.Sleep

Die Helligkeit des Geräts wird über einen bestimmten Zeitraum hinweg schrittweise verringert und optional wird auch die Farbtemperatur angepasst.

{
  "supportedEffects": [
    "sleep"
  ]
}

Parameter

Beispiele

Schalte meine Lampen für 60 Minuten in den Schlummermodus.

{
  "command": "action.devices.commands.Sleep",
  "params": {
    "duration": 3600
  }
}

action.devices.commands.StopEffect

Aktuellen Lichteffekt beenden

Parameter

Beispiele

Beende den Effekt auf meinem Licht.

{
  "command": "action.devices.commands.StopEffect",
  "params": {}
}

action.devices.commands.Wake

Die Helligkeit des Geräts wird über einen bestimmten Zeitraum hinweg schrittweise erhöht und optional auch die Farbtemperatur angepasst.

{
  "supportedEffects": [
    "wake"
  ]
}

Parameter

Beispiele

Schalte meine Beleuchtung für 60 Minuten ein.

{
  "command": "action.devices.commands.Wake",
  "params": {
    "duration": 3600
  }
}

Emulation von Lichteffekten

Wenn dein Gerät das Merkmal Brightness, aber nicht das Merkmal LightEffects implementiert, unterstützt die Plattform emulierte „Ruhemodus“- und „Ruhemodus beenden“-Effekte, ohne dass zusätzlicher Code erforderlich ist. Die Plattform emuliert die Effekte, indem sie eine Reihe von EXECUTE-Intents sendet.

Beispieläußerungen

GERÄTEFEHLER