Smart-Home-Timer-Attributschema

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

So kann beispielsweise ein intelligenter Sprinklercontroller oder ein intelligenter Lichtschalter einen integrierten Timer haben. 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ä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.

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 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.

Bundesstaaten Typ Beschreibung
timerRemainingSec Ganzzahl

Erforderlich.

Die verbleibende Zeit in Sekunden, -1 oder [0, maxTimerLimitSec]. Wenn kein Timer läuft, wird -1 festgelegt.
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
}

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.TimerStart

Starten Sie einen neuen Timer.

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 zwischen [-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

Setzen Sie den Timer des Geräts fort.

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

Eine vollständige Liste der Fehler und Ausnahmen