Schema von LightEffects für Smart Homes

action.devices.traits.LightEffects: Diese Trait gehört zu Geräten, die komplexe Beleuchtungsbefehle zum Ändern des Zustands unterstützen, z. B. Schleifen durch verschiedene Farben.

Geräte-ATTRIBUTE

Geräte mit dieser Eigenschaft melden möglicherweise die folgenden Attribute im Rahmen des SYNC-Vorgangs. Weitere Informationen zum Umgang mit SYNC-Intents finden Sie unter Intent-Auftragsausführung.

Attribute Typ Beschreibung
defaultColorLoopDuration Ganzzahl

(Standard: 1800)

Die Standarddauer in Sekunden für den Effekt, der durch den Befehl action.devices.commands.ColorLoop ausgelöst wird.

defaultSleepDuration Ganzzahl

(Standard: 1800)

Die Standarddauer in Sekunden für den Effekt, der durch den Befehl action.devices.commands.Sleep ausgelöst wird.

defaultWakeDuration Ganzzahl

(Standard: 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
Zufällig werden verschiedene Farben in einer Schleife durchlaufen.
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

Das Gerät unterstützt den Farbschleifeneffekt.

{
  "supportedEffects": [
    "colorLoop"
  ]
}

Gerät, das Schlaf-/Wach-Effekte unterstützt

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

Gerät STATES

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

Bundesstaaten Typ Beschreibung
activeLightEffect String

Aktuell aktiver Lichteffekt, falls vorhanden. Eine von supportedEffects.

Unterstützte Werte:

colorLoop
sleep
wake
lightEffectEndUnixTimestampSec Ganzzahl

Unix-Zeitstempel, wann der Effekt voraussichtlich enden wird, falls er von selbst endet

Beispiele

Welche Auswirkungen hat das aktuell auf meinem Gerät?

{
  "activeLightEffect": "colorLoop"
}

Welche Auswirkungen hat das aktuell auf meinem Gerät?

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

Momentan ist kein Lichteffekt aktiv.

{}

BEFEHLUNGEN auf dem Gerät

Geräte mit dieser Eigenschaft 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

Fordere das Gerät an, durch eine Reihe von Farben zu wechseln.

Für diesen Befehl sind die folgenden Attribute erforderlich:
{
  "supportedEffects": [
    "colorLoop"
  ]
}

Parameter

Parameter Typ Beschreibung
duration Ganzzahl

Dauer des Farbschleifenbefehls in Sekunden.

Beispiele

Eine Farbschleife der Beleuchtung für 60 Minuten

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

action.devices.commands.Sleep

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

Für diesen Befehl sind die folgenden Attribute erforderlich:
{
  "supportedEffects": [
    "sleep"
  ]
}

Parameter

Parameter Typ Beschreibung
duration Ganzzahl

Dauer des Ruhemodus-Befehls in Sekunden.

Beispiele

Lass meine Lampen 60 Minuten lang schlafen.

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

action.devices.commands.StopEffect

Aktuellen Lichteffekt stoppen.

Parameter

Parameter Typ Beschreibung

Keine Attribute

Beispiele

Beende den Effekt auf die Lampe.

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

action.devices.commands.Wake

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

Für diesen Befehl sind die folgenden Attribute erforderlich:
{
  "supportedEffects": [
    "wake"
  ]
}

Parameter

Parameter Typ Beschreibung
duration Ganzzahl

Dauer des Aktivierungsbefehls in Sekunden.

Beispiele

Stell meine Lampen für 60 Minuten aufwach.

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

Lichteffekte-Emulation

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

Beispieläußerungen

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ät ERRORS

Sehen Sie sich die vollständige Liste der Fehler und Ausnahmen an.