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: 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, |
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, |
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 [ |
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