Schema von Smart-Home-Timern

action.devices.traits.Timer: Die Timer-Trait steht für einen Timer auf einem Gerät.

Eine intelligente Sprinklersteuerung oder ein intelligenter Lichtschalter kann beispielsweise einen eingebauten Timer haben. Diese Eigenschaft kann verwendet werden, um einen integrierten Timer auf Geräten zu steuern, z. B. um einen neuen Timer zu starten, einen laufenden Timer zu pausieren und abzubrechen und zu fragen, wie viel Zeit noch übrig ist.

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
maxTimerLimitSec Ganzzahl

Erforderlich.

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

(Standard: false)

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

Beispiele

Gerät mit Timer-Limit von zwei Stunden

{
  "maxTimerLimitSec": 7200
}

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
timerRemainingSec Ganzzahl

Erforderlich.

Aktuelle verbleibende Zeit in Sekunden, -1 oder [0, maxTimerLimitSec]. Ist der Wert -1, wenn kein Timer läuft.
timerPaused Boolesch

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

Beispiele

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

{
  "timerRemainingSec": -1
}

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

{
  "timerRemainingSec": 60
}

Wie lange läuft der Timer noch? (pausiert).

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

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

Starte einen neuen Timer.

Parameter

Parameter Typ Beschreibung
timerTimeSec Ganzzahl

Erforderlich.

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

Beispiele

Stelle den Timer auf 5 Minuten.

{
  "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. Der Wert muss innerhalb von [-maxTimerLimitSec, maxTimerLimitSec] liegen.

Beispiele

Verlängere den Timer auf dem Gerät um eine Minute.

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

Der Geräte-Timer wird um 30 Sekunden abgezogen.

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

Pausiere den Timer.

Parameter

Parameter Typ Beschreibung

Keine Attribute

Beispiele

Pausiere den Timer für das 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

Setz den 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 Timer für das Gerät an.

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

Beim Anhalten des Timers ist ein Fehler aufgetreten.

Unterstützte Werte:

noTimerExists

Gerät ERRORS

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