Smart-Home-LightEffects-Attributschema

action.devices.traits.LightEffects: Dieses Attribut gehört zu Geräten, die komplexe Beleuchtungsbefehle zum Ändern 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 zum Umgang mit SYNC-Intents finden Sie unter Intent-Ausführung.

Beispiele

Gerät, das den Farbschleifeneffekt unterstützt

{
  "supportedEffects": [
    "colorLoop"
  ]
}

Gerät, das Ein-/Ausschalteffekte unterstützt

{
  "defaultSleepDuration": 300,
  "defaultWakeDuration": 600,
  "supportedEffects": [
    "sleep",
    "wake"
  ]
}

GERÄTESTATUS

Entitäten mit diesem Attribut können im Rahmen des Vorgangs QUERY die folgenden Status melden. Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Intent-Ausführung.

Beispiele

Welche Auswirkungen hat das derzeit auf mein Gerät?

{
  "activeLightEffect": "colorLoop"
}

Welche Auswirkungen hat das derzeit auf mein Gerät?

{
  "activeLightEffect": "sleep",
  "lightEffectEndUnixTimestampSec": 1595286869
}

Es ist derzeit kein Lichteffekt aktiv.

{}

Gerätebefehle

Geräte mit dieser Eigenschaft können im Rahmen des Vorgangs EXECUTE auf die folgenden Befehle reagieren. Weitere Informationen zum Umgang mit EXECUTE-Intents finden Sie unter Intent-Ausführung.

action.devices.commands.ColorLoop

Sie können das Gerät bitten, durch eine Reihe von Farben zu wechseln.

{
  "supportedEffects": [
    "colorLoop"
  ]
}

Parameter

Beispiele

Lassen Sie meine Lampen 60 Minuten lang im Farbkreis laufen.

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

action.devices.commands.Sleep

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

{
  "supportedEffects": [
    "sleep"
  ]
}

Parameter

Beispiele

Mach meine Lampen für 60 Minuten aus.

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

action.devices.commands.StopEffect

Aktuellen Lichteffekt beenden

Parameter

Beispiele

Hören Sie auf, den Effekt auf meine Lampe anzuwenden.

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

action.devices.commands.Wake

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

{
  "supportedEffects": [
    "wake"
  ]
}

Parameter

Beispiele

Schalte meine Lampen für 60 Minuten ein.

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

Emulation von Lichteffekten

Wenn Ihr Gerät das Attribut Brightness, aber nicht das Attribut LightEffects implementiert, unterstützt die Plattform emulierte „Ruhemodus“- und „Aufwach“-Effekte ohne zusätzlichen Code. Die Plattform emuliert die Effekte, indem eine Reihe von EXECUTE-Intenten gesendet wird.

Beispieläußerungen

GERÄTEFEHLER