Schema für Smart-Home-Timer

action.devices.traits.Timer: Die Timer-Eigenschaft stellt einen Timer auf einem Gerät dar.

Beispielsweise kann ein intelligenter Sprinkler-Controller oder ein intelligenter Lichtschalter über einen integrierten Timer verfügen. Diese Eigenschaft kann verwendet werden, um einen integrierten Timer zu steuern, z. B. um einen neuen Timer zu starten sowie einen laufenden Timer zu pausieren und abzubrechen und um zu fragen, wie viel Zeit noch verbleibt.

Gerät ATTRIBUTE

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

Attribute	Typ	Beschreibung
maxTimerLimitSec	Ganzzahl	Erforderlich. Gibt die längste verfügbare Timer-Einstellung auf dem Gerät an, gemessen in Sekunden.
commandOnlyTimer	Boolesch	(Standard: false) Gibt an, ob das Gerät die Einweg- (wahr) oder Zwei-Wege-Kommunikation (falsch) unterstützt. Legen Sie dieses Attribut auf „true“ fest, wenn das Gerät für einen dieser Merkmale nicht auf einen QUERY-Intent oder einen Berichtsstatus reagieren kann.

Beispiele

Gerät mit einem Zeitlimit von zwei Stunden

{
  "maxTimerLimitSec": 7200
}

Gerät STATES

Geräte mit diesem Attribut können im Rahmen des Vorgangs QUERY die folgenden Zustände 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]. Auf -1 setzen, um anzugeben, dass kein Timer läuft.
timerPaused	Boolesch	Wahr, wenn ein aktiver Timer vorhanden, aber aktuell pausiert ist.

Beispiele

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

{
  "timerRemainingSec": -1
}

Wie lange läuft der Gerätetimer noch? (läuft).

{
  "timerRemainingSec": 60
}

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

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

Gerätebefehle

Geräte mit diesem Attribut 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

Starten Sie einen neuen Timer.

Parameter

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

Beispiele

Lass den Gerätetimer für fünf Minuten laufen.

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

Ähnliche Fehler

Beim Starten des Timers ist ein Fehler aufgetreten.

Unterstützte Werte:

noTimerExists

timerValueOutOfRange

aboveMaximumTimerDuration

belowMinimumTimerDuration

action.devices.commands.TimerAdjust

Stelle die Dauer des Timers ein.

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 Timer um 1 Minute.

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

30 Sekunden vom Timer des Geräts abziehen

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

Ähnliche Fehler

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

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

Ähnliche Fehler

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

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

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

Ähnliche Fehler

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

Beenden Sie den Gerätetimer.

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

Ähnliche Fehler

Beim Stoppen des Timers ist ein Fehler aufgetreten.

Unterstützte Werte:

noTimerExists

Gerät ERRORS

Vollständige Liste der Fehler und Ausnahmen