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: false)

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, maxTimerLimitSec]. Ustaw na -1, by oznaczać, że minutnik nie jest uruchomiony.
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, maxTimerLimitSec].

Przykłady

Ustaw minutnik urządzenia na 5 minut.

{
  "command": "action.devices.commands.TimerStart",
  "params": {
    "timerTimeSec": 300
  }
}

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 [-maxTimerLimitSec, maxTimerLimitSec].

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
  }
}

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": {}
}

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": {}
}

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": {}
}

Podczas zatrzymywania minutnika wystąpił błąd.

Obsługiwane wartości:

noTimerExists

Urządzenie ERRORS

Zobacz pełną listę błędów i wyjątków.