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: 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, |
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, |
Beispiele
Stelle den Timer auf 5 Minuten.
{ "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
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 [ |
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 } }
Ähnliche Fehler
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": {} }
Ä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
Setz den Timer 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
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": {} }
Ähnliche Fehler
Beim Anhalten des Timers ist ein Fehler aufgetreten.
Unterstützte Werte:
noTimerExists