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.

Start-/Stopp-Schema für Smart Home

action.devices.traits.StartStop – Diese Eigenschaft gehört zu Geräten, die den Start- und Stoppvorgang unterstützen.

Das Starten und Stoppen eines Geräts hat eine ähnliche Funktion wie das Ein- und Ausschalten. Geräte, die diese Eigenschaft übernehmen, funktionieren beim Ein- und Ausschalten anders. Bestimmte Waschmaschinen können beispielsweise eingeschaltet werden und ihre Einstellungen werden geändert, bevor sie tatsächlich gestartet werden.

Im Gegensatz zu Geräten mit dem Status „Ein“ und „Aus“ können einige Geräte, die gestartet und beendet werden können, während eines Vorgangs pausieren. Geräte, die pausiert werden können, werden eingestellt. Bei Fortsetzen werden sie jedoch im selben Zustand fortgesetzt wie beim Pausieren. Das Aufheben der Pausierung unterscheidet sich vom Start/Neustart, unabhängig vom aktuellen Status des Geräts. Dadurch wird der Vorgang von Beginn an neu gestartet.

Einige Geräte unterstützen die Ausführung in bestimmten Zonen. Beispielsweise kann ein Rasensprenger verschiedene Bewässerungszonen haben und die Möglichkeit bieten, bestimmte Zonen separat zu gießen, während ein Staubsauger bestimmte Räume unterstützen kann.

Gerät ATTRIBUTE

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

Attribute Typ Beschreibung
pausable Boolesch

(Standard: false)

Gibt an, ob das Gerät während des Betriebs pausiert werden kann.

availableZones Array

Gibt die unterstützten Zonennamen an. Strings sollten wie vom Nutzer festgelegt lokalisiert werden. Diese Liste ist nicht exklusiv. Nutzer können beliebige Namen melden.

[item, ...] String

Name einer Zone, in der das Startgerät unterstützt wird.

Beispiele

Gerät, das pausiert werden kann und den Betrieb in mehreren Zonen unterstützt.

{
  "pausable": true,
  "availableZones": [
    "kitchen",
    "living room",
    "office",
    "bedroom"
  ]
}

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
isRunning Boolesch

Erforderlich.

Gibt an, ob das Gerät gerade in Betrieb ist.

isPaused Boolesch

Gibt an, ob das Gerät explizit pausiert ist. Wenn dieser Wert wahr ist, impliziert isRunning, dass er falsch ist, kann jedoch fortgesetzt werden.

activeZones Array

Gibt Zonen aus der Liste availableZones an, in denen das Gerät gerade ausgeführt wird.

[item, ...] String

Der Zonenname.

Beispiele

Ist das Gerät pausiert?

{
  "isRunning": false,
  "isPaused": true
}

Ist das Gerät pausiert?

{
  "isRunning": true,
  "isPaused": false
}

Läuft das Gerät?

{
  "isRunning": true,
  "isPaused": false,
  "activeZones": [
    "kitchen",
    "living room"
  ]
}

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

Starten oder stoppen Sie das Gerät.

Parameter

Parameter Typ Beschreibung
start Boolesch

Erforderlich.

"True" zum Starten des Gerätebetriebs, "False" zum Stoppen.

zone String

Gibt die Zone an, in der die Ausführung beginnen soll.

multipleZones Array

Gibt zwei oder mehr Zonen an, in denen die Ausführung beginnen soll. Wird statt zone parameter. festgelegt

[item, ...] String

Name einer Zone, in der das Gerät gestartet werden soll.

Beispiele

Starten Sie das Gerät.

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": true
  }
}

Beenden Sie das Gerät.

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": false
  }
}

Starte das Gerät im Büro.

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": true,
    "zone": "office"
  }
}

Starte das Gerät in der Küche, im Esszimmer und im Wohnzimmer.

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": true,
    "multipleZones": [
      "kitchen",
      "dining room",
      "living room"
    ]
  }
}

action.devices.commands.PauseUnpause

Gerätebetrieb pausieren oder Pausierung aufheben

Für diesen Befehl sind die folgenden Attribute erforderlich:
{
  "pausable": true
}

Parameter

Parameter Typ Beschreibung
pause Boolesch

Erforderlich.

"True" zum Pausieren, "False" zum Aufheben der Pausierung

Beispiele

Pausieren Sie das Gerät.

{
  "command": "action.devices.commands.PauseUnpause",
  "params": {
    "pause": true
  }
}

Der Nutzer hat versucht, ein Gerät zu pausieren, aber das Gerät befindet sich in einem Zustand, in dem es nicht pausiert werden kann.

Unterstützte Werte:

unpausableState

Beispieläußerungen

de-DE

  • Bitte starten Sie den Staubsauger. im Wohnzimmer .
  • Geschirrspüler
  • Staubsauger abwechseln
  • Staubsauger
  • bitte starten Die Waschmaschine

en-US

  • Ich brauche myroomba, um in den Arbeitszimmern laufen zu können
  • Jetzt den Trockner pausieren
  • Jetzt den Trockner starten
  • die Geschirrspülmaschine anhalten
  • Pausierung aufheben Geschirrspüler

es-ES

  • Parar la lava
  • pon el aspirador elliquidator
  • Pan el laavaavajillas
  • Quiero usar el friegaplatos
  • Venceve a encender la aspiradora

fr-FR

  • Allumer l'aspirateur dans le salon
  • Fortsetzung l'aspirateur .
  • Arrondissement l'aspirateur
  • Lance la Machine à laver
  • mets l'aspirateur en Pause

Gerät ERRORS

Vollständige Liste der Fehler und Ausnahmen