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