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 minutnikiem na urządzeniach, na przykład do uruchamiania nowego minutnika, wstrzymywania i anulowania uruchomionego minutnika oraz zadawania 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ę jednokierunkową (prawda) czy dwukierunkową (fałsz). Ustaw ten atrybut na „PRAWDA”, jeśli urządzenie nie może odpowiadać na intencję QUERY ani nie może zgłaszać stanu dla tej cechy.

Przykłady

Urządzenie z minutnikiem z 2-godzinnym limitem.

{
  "maxTimerLimitSec": 7200
}

Urządzenie STATES

Elementy z tą cechą mogą zgłaszać 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

Wymagane.

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? (uruchomiony).

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

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 urządzenia.

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

Odejmuje 30 sekund od minutnika urządzenia.

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

Podczas ustawiania 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": {}
}

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