Willkommen beim Google Home Developer Center, der neuen Anlaufstelle für Informationen über Smart-Home-Aktionen. Hinweis:Die Aktionen in der Actions Console werden weiterhin erstellt.

Schema der Smart Home-Timer

action.devices.traits.Timer: Die Timer-Funktion steht für einen Timer auf einem Gerät.

Ein Smart-Sprinkler-Controller oder ein intelligenter Lichtschalter kann beispielsweise einen integrierten Timer haben. Diese Eigenschaft kann verwendet werden, um einen integrierten Timer auf Geräten zu steuern, beispielsweise das Starten eines neuen Timers, das Pausieren und Abbrechen eines laufenden Timers und die Frage, wie viel Zeit noch verbleibt.

Geräte-ATTRIBUTE

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

Attribute Typ Beschreibung
maxTimerLimitSec Ganzzahl

Erforderlich.

Gibt die längste verfügbare Timer-Einstellung des Geräts in Sekunden an.

commandOnlyTimer Boolesch

(Standard: false)

Gibt an, ob das Gerät die Verwendung von Einweg- (wahr) oder Zwei-Wege-Kommunikation (falsch) unterstützt. Setzen Sie dieses Attribut auf „true“, wenn das Gerät für diese Eigenschaft nicht auf einen QUERY-Intent oder einen Berichtstatus reagieren kann.

Beispiele

Gerät mit einem Timerlimit von zwei Stunden

{
  "maxTimerLimitSec": 7200
}

Gerätestatus

Entitäten mit diesem Merkmal können im Rahmen des QUERY-Vorgangs die folgenden Status melden: Weitere Informationen zum Verarbeiten von QUERY-Intents finden Sie unter Intent-Auftragsausführung.

Bundesstaaten Typ Beschreibung
timerRemainingSec Ganzzahl

Erforderlich.

Aktuelle verbleibende Zeit in Sekunden, -1 oder [0, maxTimerLimitSec]. Gib -1 an, wenn kein Timer läuft.

timerPaused Boolesch

„True“, wenn ein aktiver Timer vorhanden, aber derzeit pausiert ist.

Beispiele

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

{
  "timerRemainingSec": -1
}

Wie lange läuft der Timer des Geräts noch? (läuft).

{
  "timerRemainingSec": 60
}

Wie lange läuft der Timer des Geräts noch? (Pausiert).

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

BEISPIELE für Geräte

Geräte mit diesem Merkmal können im Rahmen des EXECUTE-Vorgangs auf die folgenden Befehle reagieren. Weitere Informationen zum Verarbeiten von 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. muss innerhalb von [1, maxTimerLimitSec] liegen.

Beispiele

Laufen Sie den Geräte-Timer fünf Minuten lang.

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

Die Dauer des Timers anpassen.

Parameter

Parameter Typ Beschreibung
timerTimeSec Ganzzahl

Erforderlich.

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

Beispiele

Füge dem Geräte-Timer eine Minute hinzu.

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

30 Sekunden vom Geräte-Timer ab

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

Der Timer wird pausiert.

Parameter

Parameter Typ Beschreibung

Keine Attribute

Beispiele

Pausieren Sie den Geräte-Timer.

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

Beim Pausieren des Timers ist ein Fehler aufgetreten.

Unterstützte Werte:

noTimerExists

action.devices.commands.TimerResume

Der Timer wird fortgesetzt.

Parameter

Parameter Typ Beschreibung

Keine Attribute

Beispiele

Setz 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

Stoppen Sie den Timer.

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

Beim Stoppen des Timers ist ein Fehler aufgetreten.

Unterstützte Werte:

noTimerExists

Gerät ERRORS

Hier finden Sie die vollständige Liste der Fehler und Ausnahmen.