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 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
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 starte den Staubsauger im Wohnzimmer .
  • Geschirrspüler wieder anstellen
  • Staubsauger abschalten
  • Staubsauger pausieren
  • bitte starte die Waschmaschine

en-US

  • I need my roomba to start running in the den
  • pause the dryer now
  • start the dryer now
  • stop the dishwasher
  • unpause the dishwasher

es-ES

  • parar la lavadora
  • pon el aspirador en el dormitorio principal
  • pon el lavavajillas en pausa
  • quiero usar el friegaplatos
  • vuelve a encender la aspiradora

fr-FR

  • Allumer l'aspirateur dans le salon .
  • Continuer l'aspirateur .
  • arrête l'aspirateur
  • lance la machine à laver
  • mets l'aspirateur en pause

hi-IN

  • कमरे में वैक्यूम चलाओगी
  • डिशवॉशर को कुछ देर रोको
  • वैक्यूम को अनपॉज़ करो
  • वैक्यूम को चालू कर दो
  • वैक्यूम को बंद कर दो

it-IT

  • Mi accendi l'aspirapolvere in cucina ?
  • fa' partire aspirapolvere
  • fai ripartire l'aspirapolvere
  • metti in pausa l'aspirapolvere
  • stoppa l'aspirapolvere

ja-JP

  • お掃除ロボット リビング で動かして
  • 台所の食洗機 を一時停止してください
  • 掃除機 を停止して
  • 掃除機 を再開してください
  • 洗濯機 をスタートさせて

ko-KR

  • 거실 에서 청소기 돌려
  • 세탁기 좀 돌려 줘
  • 식기 세척기 다시 시작해
  • 청소기 일시 정지
  • 청소기 작동 멈춰 줘

nl-NL

  • De schoonmaakrobot inschakelen in de keuken .
  • hervat de stofzuiger
  • pauzeer de stofzuiger
  • start mijn stofzuiger
  • stop de stofzuiger

pt-BR

  • Inicia o aspersor no jardim
  • Iniciar o aspirador de pó na sala .
  • iniciar a máquina de lavar
  • parar a pausa na máquina de lavar roupa
  • parar o aspirador de pó
  • pausar o aspirador de pó

sv-SE

  • Kör igång sprinklern gräsmattan .
  • kör igång dammsugaren igen
  • pausa dammsugaren
  • starta tvättmaskinen
  • stoppa dammsugaren

Gerät ERRORS

Vollständige Liste der Fehler und Ausnahmen