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 als Teil des Vorgangs SYNC melden. Weitere Informationen zum Umgang mit SYNC-Intents finden Sie unter Intent-Fulfillment.

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 können im Rahmen des Vorgangs EXECUTE auf die folgenden Befehle reagieren. Weitere Informationen zum Umgang mit EXECUTE-Intents finden Sie unter Intent-Fulfillment.

action.devices.commands.ColorLoop

Das Gerät soll eine Reihe von Farben durchlaufen.

{
  "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 auch die Farbtemperatur angepasst.

{
  "supportedEffects": [
    "sleep"
  ]
}

Parameter

Beispiele

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

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

action.devices.commands.StopEffect

Den aktuellen Lichteffekt beenden.

Parameter

Beispiele

Beende den Effekt auf meiner Lampe.

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

action.devices.commands.Wake

Die Helligkeit des Geräts wird über einen bestimmten Zeitraum hinweg allmählich 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 Ihr Gerät das Merkmal Brightness, aber nicht das Merkmal LightEffects implementiert, unterstützt die Plattform emulierte „Schlaf“- und „Aufwach“-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