Smart Home StartStop-Trait-Schema

action.devices.traits.StartStop: Dieses Attribut gehört zu Geräten, die Start- und Stoppvorgänge 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 im eingeschalteten und im gestarteten Zustand unterschiedlich. 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 ein Ein- und ein Aus-Zustand haben, können einige Geräte, die gestartet und gestoppt werden können, auch während eines Vorgangs pausieren. Geräte, die pausiert werden können, stellen den Betrieb ein. Wenn sie fortgesetzt werden, kehren sie in den Zustand zurück, in dem sie sich vor der Pause befanden. Das Aufheben der Pause unterscheidet sich vom Starten/Neustarten, da der Betrieb unabhängig vom aktuellen Status des Geräts von Anfang an beginnt.

Einige Geräte unterstützen möglicherweise das Laufen in bestimmten Zonen. Ein Rasensprenger kann beispielsweise verschiedene Bewässerungszonen haben und die Möglichkeit bieten, bestimmte Zonen separat zu bewässern. Ein Staubsauger kann bestimmte Räume reinigen.

Geräteattribute

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

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

Für Entitäten mit diesem Merkmal können im Rahmen des Vorgangs QUERY die folgenden Status gemeldet werden. Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Intent-Fulfillment.

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 Merkmal können im Rahmen des Vorgangs EXECUTE auf die folgenden Befehle reagieren. Weitere Informationen zum Umgang mit EXECUTE-Intents finden Sie unter Intent-Fulfillment.

action.devices.commands.StartStop

Gerät starten oder beenden

Parameter

Beispiele

Starten Sie das Gerät.

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

Halte das Gerät an.

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

{
  "pausable": true
}

Parameter

Beispiele

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