Schema für das Smart-Home-Attribut „StartStop“

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

Das Starten und Beenden eines Geräts hat eine ähnliche Funktion wie das Ein- und Ausschalten. Geräte, die dieses Attribut übernehmen, funktionieren unterschiedlich, je nachdem, ob sie eingeschaltet oder gestartet werden. Bestimmte Waschmaschinen können beispielsweise eingeschaltet und ihre Einstellungen geändert werden, bevor sie tatsächlich in Betrieb genommen werden.

Im Gegensatz zu Geräten, die nur einen Ein- und Aus-Zustand haben, können einige Geräte, die gestartet und gestoppt werden können, auch während eines Vorgangs pausiert werden. Geräte, die pausiert werden können, stellen den Betrieb ein, setzen ihn aber nach dem Fortsetzen im selben Zustand fort, in dem sie pausiert wurden. Das Fortsetzen unterscheidet sich vom Starten/Neustarten, da der Vorgang unabhängig vom aktuellen Status des Geräts von vorn beginnt.

Einige Geräte unterstützen möglicherweise die Ausführung in bestimmten Zonen. Ein Sprinkler kann beispielsweise verschiedene Bewässerungszonen haben und bestimmte Zonen separat bewässern, während ein Staubsauger bestimmte Räume reinigen kann.

Geräteattribute

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-Ausführung.

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 Attribut können im Rahmen des Vorgangs QUERY die folgenden Status melden. Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Intent-Ausführung.

Beispiele

Ist das Gerät pausiert?

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

Ist das Gerät pausiert?

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

Ist das Gerät eingeschaltet?

{
  "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-Ausführung.

action.devices.commands.StartStop

Gerät starten oder beenden

Parameter

Beispiele

Starte das Gerät.

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

Gerät stoppen

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

Gerätebetrieb pausieren oder fortsetzen

{
  "pausable": true
}

Parameter

Beispiele

Pausiere das Gerät.

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

Ähnliche Fehler

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

Gerätefehler