Willkommen beim Google Home Developer Center, der neuen Anlaufstelle für Smart-Home-Aktionen. Hinweis:Sie erstellen weiterhin Aktionen in der Actions Console.
Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Schema für Smart-Home-Timer

action.devices.traits.Timer: Die Timer-Eigenschaft stellt einen Timer auf einem Gerät dar.

Beispielsweise kann ein intelligenter Sprinkler-Controller oder ein intelligenter Lichtschalter über einen integrierten Timer verfügen. Diese Eigenschaft kann verwendet werden, um einen integrierten Timer zu steuern, z. B. um einen neuen Timer zu starten sowie einen laufenden Timer zu pausieren und abzubrechen und um zu fragen, wie viel Zeit noch verbleibt.

Gerät ATTRIBUTE

Geräte mit diesem Attribut können im Rahmen des Vorgangs SYNC die folgenden Attribute melden. Weitere Informationen zum Umgang mit SYNC-Intents finden Sie unter Intent-Auftragsausführung.

Attribute Typ Beschreibung
maxTimerLimitSec Ganzzahl

Erforderlich.

Gibt die längste verfügbare Timer-Einstellung auf dem Gerät an, gemessen in Sekunden.

commandOnlyTimer Boolesch

(Standard: false)

Gibt an, ob das Gerät die Einweg- (wahr) oder Zwei-Wege-Kommunikation (falsch) unterstützt. Legen Sie dieses Attribut auf „true“ fest, wenn das Gerät für einen dieser Merkmale nicht auf einen QUERY-Intent oder einen Berichtsstatus reagieren kann.

Beispiele

Gerät mit einem Zeitlimit von zwei Stunden

{
  "maxTimerLimitSec": 7200
}

Gerät STATES

Geräte mit diesem Attribut können im Rahmen des Vorgangs QUERY die folgenden Zustände melden. Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Intent-Auftragsausführung.

Bundesstaaten Typ Beschreibung
timerRemainingSec Ganzzahl

Erforderlich.

Aktuelle verbleibende Zeit in Sekunden, -1 oder [0, maxTimerLimitSec]. Auf -1 setzen, um anzugeben, dass kein Timer läuft.

timerPaused Boolesch

Wahr, wenn ein aktiver Timer vorhanden, aber aktuell pausiert ist.

Beispiele

Wie lange läuft der Gerätetimer noch? (wird nicht ausgeführt).

{
  "timerRemainingSec": -1
}

Wie lange läuft der Gerätetimer noch? (läuft).

{
  "timerRemainingSec": 60
}

Wie lange läuft der Gerätetimer noch? (pausiert).

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

Gerätebefehle

Geräte mit diesem Attribut können im Rahmen des Vorgangs EXECUTE auf die folgenden Befehle reagieren. Weitere Informationen zum Umgang mit EXECUTE-Intents finden Sie unter Intent-Auftragsausführung.

action.devices.commands.TimerStart

Starten Sie einen neuen Timer.

Parameter

Parameter Typ Beschreibung
timerTimeSec Ganzzahl

Erforderlich.

Die Dauer des Timers in Sekunden. Der Wert muss innerhalb von [1, maxTimerLimitSec] liegen.

Beispiele

Lass den Gerätetimer für fünf Minuten laufen.

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

Beim Starten des Timers ist ein Fehler aufgetreten.

Unterstützte Werte:

noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration

action.devices.commands.TimerAdjust

Stelle die Dauer des Timers ein.

Parameter

Parameter Typ Beschreibung
timerTimeSec Ganzzahl

Erforderlich.

Positive oder negative Anpassung des Timers in Sekunden; muss innerhalb von [-maxTimerLimitSec, maxTimerLimitSec] liegen.

Beispiele

Verlängere den Timer um 1 Minute.

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

30 Sekunden vom Timer des Geräts abziehen

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

Beim Anpassen des Timers ist ein Fehler aufgetreten.

Unterstützte Werte:

noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration

action.devices.commands.TimerPause

Timer pausieren.

Parameter

Parameter Typ Beschreibung

Keine Attribute

Beispiele

Pausiere den Gerätetimer.

{
  "command": "action.devices.commands.TimerPause",
  "params": {}
}

Beim Pausieren des Timers ist ein Fehler aufgetreten.

Unterstützte Werte:

noTimerExists

action.devices.commands.TimerResume

Timer fortsetzen.

Parameter

Parameter Typ Beschreibung

Keine Attribute

Beispiele

Setze den Timer für das Gerät fort.

{
  "command": "action.devices.commands.TimerResume",
  "params": {}
}

Beim Fortsetzen des Timers ist ein Fehler aufgetreten.

Unterstützte Werte:

noTimerExists

action.devices.commands.TimerCancel

Der Timer wird abgebrochen.

Parameter

Parameter Typ Beschreibung

Keine Attribute

Beispiele

Beenden Sie den Gerätetimer.

{
  "command": "action.devices.commands.TimerCancel",
  "params": {}
}

Beim Stoppen des Timers ist ein Fehler aufgetreten.

Unterstützte Werte:

noTimerExists

Gerät ERRORS

Vollständige Liste der Fehler und Ausnahmen