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: false) 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, maxTimerLimitSec]. Ustaw wartość -1, aby wskazać, że minutnik nie jest uruchomiony.
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, 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 minutnik.

Parametry

Parametry	Typ	Opis
timerTimeSec	Liczba całkowita	Wymagany. Dodatnia lub ujemna korekta czasu w sekundach. Musi się mieścić 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 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

Urządzenie ERRORS

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