Smart-Home-Schalter-Attributschema

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

Diese Einstellungen können eine physische Schaltfläche mit dem Status „An/Aus“ oder „Aktiv/Inaktiv“, ein Kästchen in HTML oder ein anderes Element mit einem bestimmten Aktivierungs-/Deaktivierungsstatus darstellen. Wenn die Einstellung mehr als zwei Status hat oder einen Status hat, bei dem keine der binären Optionen ausgewählt ist, wird sie besser als Modes-Attribut dargestellt. Das entspricht Einstellrädern mit mehreren Status, physischen oder HTML-Optionsschaltflächen oder binären Status, die nicht explizit „An“ oder „Aus“ sind (z. B. „AM/FM“ oder „Heiß/Kalt“).

Diese Eigenschaft umfasst einen oder mehrere einzelne Schalter, die Nutzer einstellen können. Im Allgemeinen sollten diese Ein-/Aus-Schaltflächen für Funktionen verwendet werden, die nicht mit dem Verhalten anderer Geräte verknüpft sind. Für verknüpfte Verhaltensweisen, z. B. das Ein- oder Ausschalten des Geräts, sollten spezifischere Eigenschaften verwendet werden, z. B. thermostatMode im Attribut TemperatureSetting.

Geräteattribute

Geräte mit diesem Merkmal können die folgenden Attribute im Rahmen des Vorgangs SYNC melden. Weitere Informationen zum Umgang mit SYNC-Intents finden Sie unter Intent-Ausführung.

Beispiele

Gerät mit mehreren Ein-/Aus-Schaltflächen

{
  "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 nur per Befehl schaltbaren Funktionen

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

Gerät mit Ein-/Aus-Schaltflächen nur für Suchanfragen

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

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

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

Gerätebefehle

Geräte mit dieser Eigenschaft 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.SetToggles

Einen bestimmten Schalterstatus festlegen.

Parameter

Beispiele

Aktivieren Sie den Energiesparmodus.

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

Deaktivieren Sie den Filter.

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

Beispieläußerungen

GERÄTEFEHLER