Schemat atrybutu Timer w inteligentnym domu

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

Na przykład inteligentny sterownik zraszacza lub inteligentny przełącznik może mieć wbudowany minutnik. Tego atrybutu można używać do sterowania wbudowanym licznikiem czasu na urządzeniach, na przykład do uruchamiania nowego licznika czasu, wstrzymywania i anulowania uruchomionego licznika czasu oraz do pytania o pozostały czas.

ATRYBUTY URZĄDZENIA

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

Atrybuty Typ Opis
maxTimerLimitSec Liczba całkowita

Wymagany.

Wskazuje najdłuższe ustawienie minutnika dostępne na urządzeniu (w sekundach).
commandOnlyTimer Wartość logiczna

(wartość domyślna: false)

Wskazuje, czy urządzenie obsługuje komunikację w jednym kierunku (prawda) czy w obu kierunkach (fałsz). Ustaw ten atrybut na „PRAWDA”, jeśli urządzenie nie może odpowiadać na intencję QUERY lub raportować stanu dla tej cechy.

Przykłady

Urządzenie z minutnikiem z 2-godzinnym limitem.

{
  "maxTimerLimitSec": 7200
}

STANOWISKO URZĄDZENIA

Elementy z tą cechą mogą raportować te stany w ramach operacji QUERY. Więcej informacji o obsługiwaniu intencji QUERY znajdziesz w artykule Realizacja intencji.

Stany Typ Opis
timerRemainingSec Liczba całkowita

Wymagany.

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

Prawda, jeśli istnieje aktywny minutnik, ale jest wstrzymany.

Przykłady

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

{
  "timerRemainingSec": -1
}

Ile czasu zostało na minutniku urządzenia? (w trakcie wykonywania).

{
  "timerRemainingSec": 60
}

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

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

Polecenia urządzenia

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

action.devices.commands.TimerStart

Uruchom nowy minutnik.

Parametry

Parametry Typ Opis
timerTimeSec Liczba całkowita

Wymagany.

Czas trwania minutnika w sekundach; musi mieścić się w przedziale [1, maxTimerLimitSec].

Przykłady

Uruchom minutnik urządzenia 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 odmierzany przez minutnik.

Parametry

Parametry Typ Opis
timerTimeSec Liczba całkowita

Wymagany.

Dodatnia lub ujemna korekta samowyzwalacza 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 zegara 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 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 działania 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

BŁĘDY urządzenia

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