Schema der Smart Home-Timer

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

Ein Smart-Sprinkler-Controller oder ein intelligenter Lichtschalter kann beispielsweise einen integrierten Timer haben. Diese Eigenschaft kann verwendet werden, um einen integrierten Timer auf Geräten zu steuern, beispielsweise das Starten eines neuen Timers, das Pausieren und Abbrechen eines laufenden Timers und die Frage, wie viel Zeit noch verbleibt.

Geräte-ATTRIBUTE

Geräte mit diesem Merkmal können im Rahmen des SYNC-Vorgangs die folgenden Attribute melden. Weitere Informationen zum Verarbeiten von SYNC-Intents finden Sie unter Intent-Auftragsausführung.

Attribute	Typ	Beschreibung
maxTimerLimitSec	Ganzzahl	Erforderlich. Gibt die längste verfügbare Timer-Einstellung des Geräts in Sekunden an.
commandOnlyTimer	Boolesch	(Standard: false) Gibt an, ob das Gerät die Verwendung von Einweg- (wahr) oder Zwei-Wege-Kommunikation (falsch) unterstützt. Setzen Sie dieses Attribut auf „true“, wenn das Gerät für diese Eigenschaft nicht auf einen QUERY-Intent oder einen Berichtstatus reagieren kann.

Beispiele

Gerät mit einem Timerlimit von zwei Stunden

{
  "maxTimerLimitSec": 7200
}

Gerätestatus

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

Bundesstaaten	Typ	Beschreibung
timerRemainingSec	Ganzzahl	Erforderlich. Aktuelle verbleibende Zeit in Sekunden, -1 oder [0, maxTimerLimitSec]. Gib -1 an, wenn kein Timer läuft.
timerPaused	Boolesch	„True“, wenn ein aktiver Timer vorhanden, aber derzeit pausiert ist.

Beispiele

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

{
  "timerRemainingSec": -1
}

Wie lange läuft der Timer des Geräts noch? (läuft).

{
  "timerRemainingSec": 60
}

Wie lange läuft der Timer des Geräts noch? (Pausiert).

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

BEISPIELE für Geräte

Geräte mit diesem Merkmal können im Rahmen des EXECUTE-Vorgangs auf die folgenden Befehle reagieren. Weitere Informationen zum Verarbeiten von EXECUTE-Intents finden Sie unter Intent-Auftragsausführung.

action.devices.commands.TimerStart

Starten Sie einen neuen Timer.

Parameter

Parameter	Typ	Beschreibung
timerTimeSec	Ganzzahl	Erforderlich. Die Dauer des Timers in Sekunden. muss innerhalb von [1, maxTimerLimitSec] liegen.

Beispiele

Laufen Sie den Geräte-Timer fünf Minuten lang.

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

Weitere Informationen

Beim Starten des Timers ist ein Fehler aufgetreten.

Unterstützte Werte:

noTimerExists

timerValueOutOfRange

aboveMaximumTimerDuration

belowMinimumTimerDuration

action.devices.commands.TimerAdjust

Die Dauer des Timers anpassen.

Parameter

Parameter	Typ	Beschreibung
timerTimeSec	Ganzzahl	Erforderlich. Positive oder negative Anpassung des Timers in Sekunden. muss innerhalb von [-maxTimerLimitSec, maxTimerLimitSec] liegen.

Beispiele

Füge dem Geräte-Timer eine Minute hinzu.

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

30 Sekunden vom Geräte-Timer ab

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

Weitere Informationen

Beim Anpassen des Timers ist ein Fehler aufgetreten.

Unterstützte Werte:

noTimerExists

timerValueOutOfRange

aboveMaximumTimerDuration

belowMinimumTimerDuration

action.devices.commands.TimerPause

Der Timer wird pausiert.

Parameter

Parameter	Typ	Beschreibung
Keine Attribute

Beispiele

Pausieren Sie den Geräte-Timer.

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

Weitere Informationen

Beim Pausieren des Timers ist ein Fehler aufgetreten.

Unterstützte Werte:

noTimerExists

action.devices.commands.TimerResume

Der Timer wird fortgesetzt.

Parameter

Parameter	Typ	Beschreibung
Keine Attribute

Beispiele

Setz den Timer für das Gerät fort.

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

Weitere Informationen

Beim Fortsetzen des Timers ist ein Fehler aufgetreten.

Unterstützte Werte:

noTimerExists

action.devices.commands.TimerCancel

Der Timer wird abgebrochen.

Parameter

Parameter	Typ	Beschreibung
Keine Attribute

Beispiele

Stoppen Sie den Timer.

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

Weitere Informationen

Beim Stoppen des Timers ist ein Fehler aufgetreten.

Unterstützte Werte:

noTimerExists

Gerät ERRORS

Hier finden Sie die vollständige Liste der Fehler und Ausnahmen.