Smart-Home-Timer-Attributschema

action.devices.traits.Timer – Der Timer-Attribut steht für einen Timer auf einem Gerät.

So haben beispielsweise intelligente Bewässerungssteuerungen oder intelligente Lichtschalter einen integrierten Timer. Mit diesem Attribut können Sie einen integrierten Timer auf Geräten steuern, z. B. einen neuen Timer starten, einen laufenden Timer pausieren und beenden oder fragen, wie viel Zeit noch verbleibt.

Geräte-ATTRIBUTES

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.

Attribute Typ Beschreibung
maxTimerLimitSec Ganzzahl

Erforderlich.

Gibt die längste Timereinstellung an, die auf dem Gerät verfügbar ist, gemessen in Sekunden.
commandOnlyTimer Boolesch

(Standardeinstellung: false)

Gibt an, ob das Gerät die unidirektionale (wahr) oder bidirektionale (falsch) Kommunikation unterstützt. Legen Sie dieses Attribut auf „true“ fest, wenn das Gerät nicht auf eine QUERY-Intention oder den Berichtsstatus für dieses Attribut antworten kann.

Beispiele

Gerät mit einem Timerlimit von zwei Stunden

{
  "maxTimerLimitSec": 7200
}

GERÄTESTATUS

Entitäten mit diesem Merkmal können im Rahmen der QUERY-Operation die folgenden Bundesstaaten melden. Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Intent-Ausführung.

Bundesstaaten Typ Beschreibung
timerRemainingSec Ganzzahl

Erforderlich.

Die verbleibende Zeit in Sekunden, -1 oder [0, maxTimerLimitSec]. Wenn Sie -1 festlegen, wird angezeigt, dass kein Timer läuft.
timerPaused Boolesch

„Wahr“, wenn ein Timer aktiv ist, aber derzeit pausiert.

Beispiele

Wie lange läuft der Timer auf dem Gerät noch? (nicht ausgeführt).

{
  "timerRemainingSec": -1
}

Wie lange läuft der Timer auf dem Gerät noch? (running).

{
  "timerRemainingSec": 60
}

Wie lange läuft der Timer auf dem Gerät noch? (pausiert).

{
  "timerRemainingSec": 30,
  "timerPaused": true
}

BEFEHLE für Geräte

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-Auftragsausführung.

action.devices.commands.TimerStart

Neuen Timer starten

Parameter

Parameter Typ Beschreibung
timerTimeSec Ganzzahl

Erforderlich.

Dauer des Timers in Sekunden; muss zwischen [1, maxTimerLimitSec] liegen.

Beispiele

Lassen Sie den Timer des Geräts fünf Minuten lang laufen.

{
  "command": "action.devices.commands.TimerStart",
  "params": {
    "timerTimeSec": 300
  }
}

Beim Starten des Timers ist ein Fehler aufgetreten.

Unterstützte Werte:

noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration

action.devices.commands.TimerAdjust

Passen Sie die Dauer des Timers an.

Parameter

Parameter Typ Beschreibung
timerTimeSec Ganzzahl

Erforderlich.

Positive oder negative Anpassung des Timers in Sekunden; muss innerhalb von [-maxTimerLimitSec, maxTimerLimitSec] liegen.

Beispiele

Dem Timer des Geräts eine Minute hinzufügen

{
  "command": "action.devices.commands.TimerAdjust",
  "params": {
    "timerTimeSec": 60
  }
}

Subtrahiert 30 Sekunden vom Timer des Geräts.

{
  "command": "action.devices.commands.TimerAdjust",
  "params": {
    "timerTimeSec": -30
  }
}

Beim Einstellen des Timers ist ein Fehler aufgetreten.

Unterstützte Werte:

noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration

action.devices.commands.TimerPause

Timer pausieren

Parameter

Parameter Typ Beschreibung

Keine Attribute

Beispiele

Pausieren Sie den Timer auf dem Gerät.

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

Beim Pausieren des Timers ist ein Fehler aufgetreten.

Unterstützte Werte:

noTimerExists

action.devices.commands.TimerResume

Timer fortsetzen.

Parameter

Parameter Typ Beschreibung

Keine Attribute

Beispiele

Timer des Geräts fortsetzen

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

Beim Fortsetzen des Timers ist ein Fehler aufgetreten.

Unterstützte Werte:

noTimerExists

action.devices.commands.TimerCancel

Timer abbrechen

Parameter

Parameter Typ Beschreibung

Keine Attribute

Beispiele

Stoppen Sie den Timer auf dem Gerät.

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

Beim Anhalten des Timers ist ein Fehler aufgetreten.

Unterstützte Werte:

noTimerExists

GERÄTEFEHLER

Vollständige Liste der Fehler und Ausnahmen