Smart-Home-LightEffects-Attributschema

action.devices.traits.LightEffects: Diese Eigenschaft gehört zu Geräten, die komplexe Beleuchtungsbefehle zum Ändern des Zustands unterstützen können, z. B. Schleifen durch verschiedene 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 aktuell auf mein Gerät?

{
  "activeLightEffect": "colorLoop"
}

Welche Auswirkungen hat das derzeit auf mein Gerät?

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

Derzeit ist kein Lichteffekt aktiv.

{}

BEFEHLE für Geräte

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

action.devices.commands.ColorLoop

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

{
  "supportedEffects": [
    "colorLoop"
  ]
}

Parameter

Beispiele

Bewegen Sie meine Lampen 60 Minuten lang in einer Farbschleife.

{
  "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

Lass die Lampen 60 Minuten lang in den Ruhemodus wechseln.

{
  "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

Erhöhen Sie nach und nach die Helligkeit des Geräts und passen Sie optional die Farbtemperatur über einen längeren Zeitraum an.

{
  "supportedEffects": [
    "wake"
  ]
}

Parameter

Beispiele

Stell mein Licht für 60 Minuten ein.

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

Emulation von Lichteffekten

Wenn auf deinem Gerät das Trait Brightness, aber nicht das Trait LightEffects implementiert ist, unterstützt die Plattform emulierte Schlaf- und Wake-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