Witamy w Google Home Developer Center – nowym miejscu, z którego dowiesz się, jak tworzyć inteligentne działania domowe. Uwaga: nadal będziesz tworzyć działania w konsoli Actions.
Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

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

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

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

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

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.