Schemat funkcji minutnika inteligentnego domu
action.devices.traits.Timer
– cecha Timer reprezentuje minutnik na urządzeniu.
Na przykład inteligentny kontroler zraszaczem lub inteligentny przełącznik oświetlenia może mieć wbudowany minutnik. Ta funkcja może służyć do sterowania wbudowanego minutnika na urządzeniach – np. włączania nowego minutnika, wstrzymywania i anulowania uruchomionego minutnika oraz do pytania, ile czasu pozostało do końca.
Urządzenie ATTRIBUTES
Urządzenia z tą cechą mogą zgłaszać poniższe atrybuty w ramach operacji SYNC
. Więcej informacji o obsłudze intencji SYNC
znajdziesz w artykule o realizacji intencji.
Atrybuty | Typ | Opis |
---|---|---|
maxTimerLimitSec |
Liczba całkowita |
Wymagane. Określa najdłuższe ustawienie minutnika dostępne na urządzeniu (w sekundach). |
commandOnlyTimer |
Wartość logiczna |
(Domyślnie: Określa, czy urządzenie obsługuje komunikację jednokierunkową (prawda) czy dwukierunkową (fałsz). Ustaw ten atrybut na wartość true, jeśli urządzenie nie może odpowiedzieć na intencję QUERY lub stan raportu w przypadku tej cechy. |
Przykłady
Urządzenie z limitem minutnika do 2 godzin.
{ "maxTimerLimitSec": 7200 }
Urządzenie STATES
Encje z tą cechą mogą zgłaszać poniższe stany w ramach operacji QUERY
. Więcej informacji o obsłudze intencji QUERY
znajdziesz w artykule o realizacji intencji.
Stany | Typ | Opis |
---|---|---|
timerRemainingSec |
Liczba całkowita |
Wymagane. Aktualny pozostały czas w sekundach, -1 lub [0, |
timerPaused |
Wartość logiczna |
Prawda, jeśli aktywny minutnik istnieje, ale jest obecnie wstrzymany. |
Przykłady
Ile czasu pozostało na minutniku urządzenia? (nie jest aktywna).
{ "timerRemainingSec": -1 }
Ile czasu pozostało na minutniku urządzenia? (aktywny).
{ "timerRemainingSec": 60 }
Ile czasu pozostało na minutniku urządzenia? (wstrzymana).
{ "timerRemainingSec": 30, "timerPaused": true }
CommandS na urządzeniu
Urządzenia z tą cechą mogą reagować na podane niżej polecenia w ramach operacji EXECUTE
. Więcej informacji o obsłudze intencji EXECUTE
znajdziesz w artykule o realizacji intencji.
action.devices.commands.TimerStart
Uruchom nowy minutnik.
Parametry
Parametry | Typ | Opis |
---|---|---|
timerTimeSec |
Liczba całkowita |
Wymagane. Minutnik w sekundach. Musi się mieścić w zakresie [1, |
Przykłady
Ustaw minutnik urządzenia na 5 minut.
{ "command": "action.devices.commands.TimerStart", "params": { "timerTimeSec": 300 } }
Powiązane błędy
Podczas włączania minutnika wystąpił błąd.
Obsługiwane wartości:
noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration
action.devices.commands.TimerAdjust
Dostosuj czas trwania minutnika.
Parametry
Parametry | Typ | Opis |
---|---|---|
timerTimeSec |
Liczba całkowita |
Wymagane. Dodatnia lub ujemna zmiana czasu w sekundach; musi mieścić się w zakresie [ |
Przykłady
Dodaj minutę do minutnika urządzenia.
{ "command": "action.devices.commands.TimerAdjust", "params": { "timerTimeSec": 60 } }
Odejmuje 30 sekund od minutnika urządzenia.
{ "command": "action.devices.commands.TimerAdjust", "params": { "timerTimeSec": -30 } }
Powiązane błędy
Podczas dostosowywania minutnika wystąpił błąd.
Obsługiwane wartości:
noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration
action.devices.commands.TimerPause
Wstrzymaj minutnik.
Parametry
Parametry | Typ | Opis |
---|---|---|
Brak właściwości |
Przykłady
Wstrzymaj minutnik urządzenia.
{ "command": "action.devices.commands.TimerPause", "params": {} }
Powiązane błędy
Podczas wstrzymywania minutnika wystąpił błąd.
Obsługiwane wartości:
noTimerExists
action.devices.commands.TimerResume
Wznów minutnik.
Parametry
Parametry | Typ | Opis |
---|---|---|
Brak właściwości |
Przykłady
Wznów minutnik urządzenia.
{ "command": "action.devices.commands.TimerResume", "params": {} }
Powiązane błędy
Podczas wznawiania odliczania wystąpił błąd.
Obsługiwane wartości:
noTimerExists
action.devices.commands.TimerCancel
Anuluj minutnik.
Parametry
Parametry | Typ | Opis |
---|---|---|
Brak właściwości |
Przykłady
Zatrzymaj minutnik urządzenia.
{ "command": "action.devices.commands.TimerCancel", "params": {} }
Powiązane błędy
Podczas zatrzymywania minutnika wystąpił błąd.
Obsługiwane wartości:
noTimerExists