Smart Home-Schalter – Schematyp

action.devices.traits.Toggles: Dieses Merkmal gehört zu allen Geräten mit Einstellungen, die nur in einem von zwei Zuständen vorhanden sein können.

Diese Einstellungen können eine physische Ein/Aus-Schaltfläche, ein Kontrollkästchen in HTML oder ein anderes Element darstellen, das speziell aktiviert/deaktiviert ist. Wenn die Einstellung mehr als zwei Zustände hat oder einen Zustand, in dem keine der binären Optionen ausgewählt ist, wird sie besser als Modes-Attribut dargestellt. Das entspricht Drehreglern mit mehreren Zuständen, Optionsfeldern (physisch oder HTML) oder binären Zuständen, die nicht explizit „Ein/Aus“ sind (z. B. „AM/FM“ oder „Heiß/Kalt“).

Dieses Attribut umfasst ein oder mehrere individuelle Ein/Aus-Schalter, die Nutzer festlegen können. Im Allgemeinen sollten diese Ein/Aus-Schalter für Funktionen verwendet werden, die nicht mit dem Verhalten anderer Geräte verknüpft sind. Für verknüpftes Verhalten, z. B. das Ein- oder Ausschalten des Geräts selbst, sollten spezifischere Eigenschaften verwendet werden (z. B. thermostatMode in der Eigenschaft TemperatureSetting).

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 mit mehreren Ein/Aus-Schaltern

{
  "availableToggles": [
    {
      "name": "sterilization_toggle",
      "name_values": [
        {
          "name_synonym": [
            "Clean",
            "Bio clean"
          ],
          "lang": "en"
        }
      ]
    },
    {
      "name": "energysaving_toggle",
      "name_values": [
        {
          "name_synonym": [
            "Energy saving",
            "Eco"
          ],
          "lang": "en"
        }
      ]
    }
  ]
}

Gerät mit Schaltern, die nur Befehle unterstützen:

{
  "availableToggles": [
    {
      "name": "filter_toggle",
      "name_values": [
        {
          "name_synonym": [
            "Filtered",
            "Filter"
          ],
          "lang": "en"
        }
      ]
    }
  ],
  "commandOnlyToggles": true
}

Gerät mit Ein/Aus-Schaltern für Anfragen:

{
  "availableToggles": [
    {
      "name": "filter_toggle",
      "name_values": [
        {
          "name_synonym": [
            "Filtered",
            "Filter"
          ],
          "lang": "en"
        }
      ]
    }
  ],
  "queryOnlyToggles": true
}

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 die Sterilisierung aktiviert?

{
  "currentToggleSettings": {
    "sterilization_toggle": true,
    "energysaving_toggle": false
  }
}

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

Einen bestimmten Umschaltstatus festlegen.

Parameter

Beispiele

Energiesparmodus aktivieren

{
  "command": "action.devices.commands.SetToggles",
  "params": {
    "updateToggleSettings": {
      "energysaving_toggle": true
    }
  }
}

Filter deaktivieren:

{
  "command": "action.devices.commands.SetToggles",
  "params": {
    "updateToggleSettings": {
      "filter_toggle": false
    }
  }
}

Beispieläußerungen

GERÄTEFEHLER