Schemat cechy timera inteligentnego domu

action.devices.traits.Timer – cecha Timer reprezentuje minutnik na urządzeniu.

Na przykład inteligentny sterownik zraszacza lub inteligentne oświetlenie może mieć wbudowany timer. Ta cecha może służyć do sterowania wbudowanym minutnikiem na urządzeniach, np. do uruchamiania nowego minutnika, wstrzymywania i anulowania działającego minutnika oraz sprawdzania, ile czasu pozostało.

ATRYBUTY urządzenia

Urządzenia z tą cechą mogą zgłaszać te atrybuty w ramach operacji SYNC. Więcej informacji o obsłudze intencji SYNC znajdziesz w artykule Realizacja intencji.

Atrybuty Typ Opis
maxTimerLimitSec Liczba całkowita

Wymagane.

Wskazuje najdłuższy czasomierz dostępny na urządzeniu, mierzony w sekundach.

Wartość minimalna: 1.
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 odpowiadać na intencję QUERY ani zgłaszać stanu w przypadku tej cechy.

Przykłady

Urządzenie z limitem czasu wynoszącym 2 godziny.

{
  "maxTimerLimitSec": 7200
}

Stany urządzenia

Podmioty z tą cechą mogą zgłaszać te stany w ramach operacji QUERY. Więcej informacji o obsłudze intencji QUERY znajdziesz w artykule Realizacja intencji.

Stany Typ Opis
timerRemainingSec Liczba całkowita

Wymagane.

Aktualny czas pozostały w sekundach, -1 lub [0, maxTimerLimitSec]. Ustaw wartość -1, aby wskazać, że nie działa żaden stoper.
timerPaused Wartość logiczna

Wartość „prawda”, jeśli istnieje aktywny minutnik, który jest obecnie wstrzymany.

Przykłady

Ile czasu pozostało na minutniku urządzenia? (nie działa).

{
  "timerRemainingSec": -1
}

Ile czasu pozostało na minutniku urządzenia? (uruchomiony).

{
  "timerRemainingSec": 60
}

Ile czasu pozostało na minutniku urządzenia? (wstrzymano).

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

Polecenia dotyczące urządzenia

Urządzenia z tą cechą mogą odpowiadać na te polecenia w ramach operacji EXECUTE. Więcej informacji o obsłudze intencji EXECUTE znajdziesz w artykule Realizacja intencji.

action.devices.commands.TimerStart

Uruchom nowy minutnik.

Parametry

Parametry Typ Opis
timerTimeSec Liczba całkowita

Wymagane.

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

Wartość minimalna: 1.

Przykłady

Uruchom timer urządzenia na 5 minut.

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

Podczas uruchamiania timera 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 korekta timera 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 czasu na urządzeniu.

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

Podczas dostosowywania timera 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 timera 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 timera wystąpił błąd.

Obsługiwane wartości:

noTimerExists

BŁĘDY urządzenia

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