Schema für Smart-Home-Start- und Stopp-Trait

action.devices.traits.StartStop: Diese Trait gehört zu Geräten, die das Starten und Beenden von Vorgängen unterstützen.

Das Starten und Stoppen eines Geräts funktioniert ähnlich wie das Ein- und Ausschalten. Geräte, die diese Eigenschaft beim Ein- und Ausschalten unterschiedlich übernehmen, funktionieren ähnlich. Bestimmte Waschmaschinen können beispielsweise eingeschaltet werden und ihre Einstellungen ändern, bevor sie tatsächlich in Betrieb genommen werden.

Im Gegensatz zu Geräten, die lediglich einen Ein- und Aus-Zustand haben, können einige Geräte, die gestartet und beendet werden können, auch während der Ausführung eines Vorgangs pausiert werden. Geräte, die pausiert werden können, werden beendet, werden aber beim Fortsetzen im selben Zustand wie beim Pausieren fortgesetzt. Das Aufheben der Pausierung unterscheidet sich vom Starten/Neustart, da der Vorgang unabhängig vom aktuellen Status des Geräts von Anfang an gestartet wird.

Einige Geräte unterstützen möglicherweise die Ausführung in bestimmten Zonen. Eine Rasensprengeranlage kann beispielsweise verschiedene Bewässerungszonen haben und die Fähigkeit unterstützen, bestimmte Bereiche separat zu bewässern, während ein Staubsauger möglicherweise die Reinigung bestimmter Räume unterstützt.

Geräte-ATTRIBUTE

Geräte mit dieser Eigenschaft melden möglicherweise die folgenden Attribute im Rahmen des SYNC-Vorgangs. 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 unterstützte Zonennamen an. Strings sollten gemäß den Vorgaben des Nutzers lokalisiert werden. Diese Liste ist nicht exklusiv. Die Nutzer können jeden beliebigen 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

Entitäten mit diesem Trait können die folgenden Status im Rahmen des QUERY-Vorgangs 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 wurde. Wenn dieser Wert „true“ ist, bedeutet dies, dass isRunning „false“ ist, aber fortgesetzt werden kann.

activeZones Array

Gibt Zonen an, in denen das Gerät derzeit ausgeführt wird (aus der availableZones-Liste).

[item, ...] String

Der Zonenname.

Beispiele

Wurde das Gerät pausiert?

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

Wurde das Gerät pausiert?

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

Läuft das Gerät?

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

BEFEHLUNGEN auf dem Gerät

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

action.devices.commands.StartStop

Starten oder beenden Sie das Gerät.

Parameter

Parameter Typ Beschreibung
start Boolesch

Erforderlich.

„True“, um den Gerätevorgang zu starten, „false“, um den Vorgang zu beenden.

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 anstelle von zone parameter. festgelegt

[item, ...] String

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

Beispiele

Starte das Gerät.

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

Halten Sie das Gerät an.

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

Schalte das Gerät im Büro ein.

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

Pausiere 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
  • 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 gräsmattan .
  • har dammsugaren i vardagsrummet startat?
  • kör igång dammsugaren igen
  • pausa dammsugaren
  • starta tvättmaskinen
  • stoppa dammsugaren

Gerät ERRORS

Sehen Sie sich die vollständige Liste der Fehler und Ausnahmen an.