Schemat inteligentnego licznika czasu w domu
action.devices.traits.Timer
– cecha licznika czasu na urządzeniu.
Na przykład inteligentny kontroler zraszacza lub przełącznik inteligentnego oświetlenia może mieć wbudowany minutnik. Ta funkcja może służyć do sterowania wbudowanym zegarem na urządzeniach, na przykład uruchamianie nowego minutnika, wstrzymywanie i anulowanie aktywnego minutnika oraz pytanie, ile czasu pozostało.
ATRYBUTY urządzenia
W ramach operacji SYNC
urządzenia z tą cechą mogą zgłaszać wymienione poniżej atrybuty. Więcej informacji o obsłudze intencji SYNC
znajdziesz w sekcji Realizacja intencji.
Atrybuty | Typ | Opis |
---|---|---|
maxTimerLimitSec |
Liczba całkowita |
Wymagany. Określa najdłuższy ustawiony minutnik na urządzeniu (liczony w sekundach). |
commandOnlyTimer |
Wartość logiczna |
(domyślnie: Wskazuje, 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 tego atrybutu. |
Przykłady
Urządzenie z limitem czasu ustawionym na dwie godziny
{ "maxTimerLimitSec": 7200 }
Urządzenie STATES
W ramach operacji QUERY
encje o tym atrybucie mogą raportować te stany. Więcej informacji o obsłudze intencji QUERY
znajdziesz w sekcji Realizacja intencji.
Stany | Typ | Opis |
---|---|---|
timerRemainingSec |
Liczba całkowita |
Wymagany. Aktualny czas w sekundach, -1 lub [0, |
timerPaused |
Wartość logiczna |
Wartość to „prawda”, jeśli aktywny minutnik istnieje, ale jest obecnie wstrzymany. |
Przykłady
Ile czasu zostało na minutniku urządzenia? (funkcja nieaktywna).
{ "timerRemainingSec": -1 }
Ile czasu zostało na minutniku urządzenia? (uruchomiona).
{ "timerRemainingSec": 60 }
Ile czasu zostało na minutniku urządzenia? (wstrzymana).
{ "timerRemainingSec": 30, "timerPaused": true }
Polecenie urządzenia
W ramach operacji EXECUTE
urządzenia z tą cechą mogą odpowiadać na podane niżej polecenia. Więcej informacji o obsłudze intencji EXECUTE
znajdziesz w sekcji Realizacja intencji.
action.devices.commands.TimerStart
Włącz nowy minutnik.
Parametry
Parametry | Typ | Opis |
---|---|---|
timerTimeSec |
Liczba całkowita |
Wymagany. Czas trwania minutnika w sekundach. Musi się mieścić w zakresie [1, |
Przykłady
Uruchamiaj minutnik na 5 minut.
{ "command": "action.devices.commands.TimerStart", "params": { "timerTimeSec": 300 } }
Powiązane błędy
Podczas uruchamiania minutnika wystąpił błąd.
Obsługiwane wartości:
noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration
action.devices.commands.TimerAdjust
Dostosuj minutnik.
Parametry
Parametry | Typ | Opis |
---|---|---|
timerTimeSec |
Liczba całkowita |
Wymagany. Dodatnia lub ujemna korekta czasu w sekundach. Musi się mieścić w zakresie [ |
Przykłady
Dodaj minutę do minutnika na urządzeniu
{ "command": "action.devices.commands.TimerAdjust", "params": { "timerTimeSec": 60 } }
Odejmuje 30 sekund od licznika czasu na urządzeniu.
{ "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 na urządzeniu.
{ "command": "action.devices.commands.TimerResume", "params": {} }
Powiązane błędy
Podczas wznawiania minutnika 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