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

Powiązane błędy

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

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

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

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

Powiązane błędy

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.