Schemat podpunktu licznika czasu domowego

action.devices.traits.Timer – cecha licznika czasu na urządzeniu.

Na przykład inteligentny kontroler spryskiwacza lub inteligentne oświetlenie może mieć wbudowany minutnik. Ta funkcja może służyć do sterowania wbudowanym stoperem na urządzeniach, takich jak uruchamianie nowego minutnika oraz wstrzymywanie i anulowanie aktywnego minutnika, a także pytanie o pozostały czas.

ATTRIBUTES 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

Wymagane.

Wskazuje najdłuższe ustawienie licznika na urządzeniu, mierzone w sekundach.
commandOnlyTimer Wartość logiczna

(Domyślnie: false)

Wskazuje, czy urządzenie obsługuje komunikację jednokierunkową (prawda) czy dwukierunkową (fałsz). Ustaw ten atrybut na wartość true (prawda), 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 wynoszącym 2 godziny.

{
  "maxTimerLimitSec": 7200
}

Urządzenie STATES

W ramach operacji QUERY encje z tą cechą mogą zgłaszać wymienione poniżej stany. Więcej informacji o obsłudze intencji QUERY znajdziesz w sekcji Realizacja intencji.

Stany Typ Opis
timerRemainingSec Liczba całkowita

Wymagane.

Bieżący czas w sekundach, -1 lub [0, maxTimerLimitSec]. Ustaw wartość -1, aby wskazać, że minutnik nie jest aktywny.
timerPaused Wartość logiczna

Wartość to „prawda”, jeśli aktywny minutnik jest obecny, ale obecnie jest wstrzymany.

Przykłady

Ile czasu zostało na minutniku urządzenia? (opcja niedostępna).

{
  "timerRemainingSec": -1
}

Ile czasu zostało na minutniku urządzenia? Podczas biegania.

{
  "timerRemainingSec": 60
}

Ile czasu zostało na minutniku urządzenia? (wstrzymana).

{
  "timerRemainingSec": 30,
  "timerPaused": true
}

Urządzenie CommandS

W ramach operacji EXECUTE urządzenia z tą cechą mogą reagować na podane niżej polecenia. Więcej informacji o obsłudze intencji EXECUTE znajdziesz w sekcji Realizacja intencji.

action.devices.commands.TimerStart

Uruchom nowy minutnik.

Parametry

Parametry Typ Opis
timerTimeSec Liczba całkowita

Wymagane.

Czas trwania licznika w sekundach. Musi się mieścić w zakresie [1, maxTimerLimitSec].

Przykłady

Uruchamiaj minutnik na 5 minut.

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

Podczas uruchamiania 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.

Wartość dodatnia lub ujemna w sekundach. Musi mieścić się w zakresie [-maxTimerLimitSec, maxTimerLimitSec].

Przykłady

Dodaj minutę do minutnika na urządzeniu.

{
  "command": "action.devices.commands.TimerAdjust",
  "params": {
    "timerTimeSec": 60
  }
}

Odejmuje 30 sekund od licznika czasu 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 na urządzeniu.

{
  "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 na urządzeniu.

{
  "command": "action.devices.commands.TimerResume",
  "params": {}
}

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 na urządzeniu.

{
  "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.