Schema für Smart-Home-Timer

action.devices.traits.Timer: Die Funktion „Timer“ steht für einen Timer auf einem Gerät.

Zum Beispiel eine intelligente Rasensprengersteuerung oder intelligente Glühbirne hat möglicherweise einen integrierten Timer. Mit diesem Trait kann ein integrierter Timer für wie z. B. das Starten eines neuen Timers sowie das Pausieren und Abbrechen eines laufenden Timers und wie viel Zeit noch übrig ist.

Geräte-ATTRIBUTES

Auf Geräten mit diesem Trait kann Folgendes gemeldet werden im Rahmen des SYNC-Vorgangs verwenden. Weitere Informationen Weitere Informationen zum Umgang mit SYNC-Intents finden Sie unter Absichtliche Umsetzung.

Attribute Typ Beschreibung
maxTimerLimitSec Ganzzahl

Erforderlich.

Gibt die längste verfügbare Timer-Einstellung auf dem Gerät an, gemessen in Sekunden.
commandOnlyTimer Boolesch

(Standardeinstellung: false)

Gibt an, ob das Gerät die unidirektionale (wahr) oder bidirektionale (falsche) Kommunikation unterstützt. Setzen Sie dieses Attribut auf „true“, wenn das Gerät nicht auf einen QUERY-Intent oder „Report State“ für dieses Merkmal reagieren kann.

Beispiele

Gerät mit einer Beschränkung von zwei Stunden.

{
  "maxTimerLimitSec": 7200
}

Gerät: STATES

Entitäten mit diesem Merkmal melden möglicherweise Folgendes: QUERY-Bundesstaaten. Weitere Informationen Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Absichtliche Umsetzung.

Bundesstaaten Typ Beschreibung
timerRemainingSec Ganzzahl

Erforderlich.

Aktuelle verbleibende Zeit in Sekunden, -1 oder [0, maxTimerLimitSec]. Stellen Sie den Wert auf -1, wenn kein Timer ausgeführt wird.
timerPaused Boolesch

"True", wenn ein aktiver Timer vorhanden ist, aber derzeit pausiert ist.

Beispiele

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

{
  "timerRemainingSec": -1
}

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

{
  "timerRemainingSec": 60
}

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

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

Gerät "COMMANDS"

Geräte mit diesem Merkmal können auf Folgendes reagieren im Rahmen des EXECUTE-Vorgangs ausgeführt. Weitere Informationen Weitere Informationen zum Umgang mit EXECUTE-Intents finden Sie unter Absichtliche Umsetzung.

action.devices.commands.TimerStart

Neuen Timer starten

Parameter

Parameter Typ Beschreibung
timerTimeSec Ganzzahl

Erforderlich.

Dauer des Timers in Sekunden muss innerhalb von [1, maxTimerLimitSec] liegen.

Beispiele

Geräte-Timer 5 Minuten laufen lassen

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

Passe 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

Verlängere den Geräte-Timer um eine Minute.

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

Subtrahiert vom Geräte-Timer 30 Sekunden.

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

Beim Anpassen 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

Pausiere den Geräte-Timer.

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

Beim Pausieren des Timers ist ein Fehler aufgetreten.

Unterstützte Werte:

noTimerExists

action.devices.commands.TimerResume

Setze den Timer fort.

Parameter

Parameter Typ Beschreibung

Keine Attribute

Beispiele

Setze den Geräte-Timer fort.

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

Beim Fortsetzen des Timers ist ein Fehler aufgetreten.

Unterstützte Werte:

noTimerExists

action.devices.commands.TimerCancel

Brich den Timer ab.

Parameter

Parameter Typ Beschreibung

Keine Attribute

Beispiele

Halte den Geräte-Timer an.

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