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-Startstopp-Fahrt

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 eines Geräts. Geräte, die diese Merkmalsfunktion übernehmen, werden beim Ein- und Ausschalten anders ausgeführt. 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 einem aktivierten und deaktivierten Status können einige Geräte beim Starten und Beenden während des Vorgangs pausiert werden. Geräte, die pausiert werden können, werden beendet. Nach dem Fortsetzen werden sie jedoch im selben Zustand fortgesetzt wie beim Pausieren. Das Aufheben der Pausierung unterscheidet sich vom Starten/Neustarten, unabhängig vom aktuellen Gerätestatus. Dadurch wird der Vorgang von Beginn an fortgesetzt.

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

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
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 lokalisiert werden, so wie sie vom Nutzer festgelegt wurden. 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ä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
isRunning Boolesch

Erforderlich.

Zeigt an, ob das Gerät gerade in Betrieb ist.
isPaused Boolesch

Gibt an, ob das Gerät ausdrücklich pausiert ist. Wenn dieser Wert wahr ist, bedeutet dies, dass isRunning falsch ist, aber fortgesetzt werden kann.
activeZones Array

Gibt Zonen an, in denen das Gerät gerade ausgeführt wird. Liste der availableZones.
[item, ...] String

Der Zonenname.

Beispiele

Ist das Gerät pausiert?

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

Ist das Gerät pausiert?

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

Ist das Gerät in Betrieb?

{
  "isRunning": true,
  "isPaused": false,
  "activeZones": [
    "Kitchen",
    "Living room"
  ]
}

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

Gerät starten oder beenden

Parameter

Parameter Typ Beschreibung
start Boolesch

Erforderlich.

True, um den Gerätebetrieb zu starten, False, um den Vorgang zu beenden.
zone String

Gibt die Zone an, in der die Ausführung gestartet werden soll.
multipleZones Array

Gibt zwei oder mehr Zonen an, in denen die Ausführung gestartet werden soll. Wird statt zone parameter. festgelegt
[item, ...] String

Name eines Bereichs, in dem 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
  }
}

Starten Sie 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

Sie können den Gerätebetrieb pausieren oder die Pausierung wieder 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. Es kann jedoch nicht pausiert werden.

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
  • ist die Waschmaschine fertig

en-US

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

es-ES

  • dime si ha acabado el lavavajillas
  • parar la lavadora
  • 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
  • est-ce que l'aspirateur est en marche
  • 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
  • la lavatrice è in funzione
  • metti in pausa l'aspirapolvere
  • stoppa l'aspirapolvere

ja-JP

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

ko-KR

  • 거실 에서 청소기 돌려
  • 건조기 돌아가고 있나
  • 세탁기 좀 돌려 줘
  • 식기 세척기 다시 시작해
  • 청소기 일시 정지
  • 청소기 작동 멈춰 줘

nl-NL

  • De schoonmaakrobot inschakelen in de keuken .
  • Is de stofzuiger klaar
  • 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
  • o aspirador está parado?
  • 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 på gräsmattan .
  • har dammsugaren i vardagsrummet startat?
  • kör igång dammsugaren igen
  • pausa dammsugaren
  • starta tvättmaskinen
  • stoppa dammsugaren

Gerät ERRORS

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