Smart Home schaltet Trait-Schema ein/aus

action.devices.traits.Toggles: Diese Trait gehört zu allen Geräten, deren Einstellungen nur einen von zwei Status haben.

Diese Einstellungen können eine physische Schaltfläche mit einem Ein/Aus oder Aktiv/Inaktiv-Status, ein Kästchen in HTML oder ein anderes speziell aktiviertes/deaktiviertes Element sein. Wenn die Einstellung mehr als zwei Zustände hat oder einen Status hat, in dem keine der binären Optionen ausgewählt ist, wird sie besser als Modes-Merkmal dargestellt. Diese Eigenschaft entspricht Drehknöpfen mit mehreren Zuständen, Optionsfeldern (physisch oder HTML) oder binären Zuständen, die nicht explizit ein-/ausgeschaltet sind (z. B. „AM/FM“ oder „heiß/kalt“).

Diese Trait umfasst eine oder mehrere einzelne Ein-/Aus-Schaltflächen, die Nutzer festlegen können. Im Allgemeinen sollten diese Ein-/Aus-Schaltflächen für Funktionen verwendet werden, die nicht mit anderen Geräteverhalten verknüpft sind. Bei verknüpften Verhaltensmustern, z. B. beim Ein- oder Ausschalten des Geräts, sollten spezifischere Eigenschaften verwendet werden (z. B. thermostatMode im Trait TemperatureSetting).

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
availableToggles	Array	Erforderlich. Liste der verfügbaren Ein-/Aus-Schaltflächen.
[item, ...]	Objekt	Ein-/Aus-Schaltfläche für „Verfügbar“.
name	String	Erforderlich. Interner Name der Ein-/Aus-Schaltfläche, der in Befehlen und Status verwendet wird. Diese Option ist möglicherweise nicht nutzerfreundlich und wird für alle Sprachen verwendet.
name_values	Array	Erforderlich. Synonyme der Ein-/Aus-Schaltfläche in den einzelnen unterstützten Sprachen.
[item, ...]	Objekt	Synonyme der Ein-/Aus-Schaltfläche in einer bestimmten Sprache.
name_synonym	Array	Erforderlich. Synonyme für die Ein-/Aus-Schaltfläche. Der erste String in dieser Liste wird als kanonischer Name der Ebene in dieser Sprache verwendet.
[item, ...]	String	Synonym name.
lang	String	Erforderlich. Sprachcode (ISO 639-1). Weitere Informationen zu unterstützten Sprachen
commandOnlyToggles	Boolesch	(Standard: false) Gibt an, ob das Gerät die unidirektionale (wahr) oder die bidirektionale (falsche) Kommunikation unterstützt. Setze dieses Attribut auf „true“, wenn das Gerät für diese Eigenschaft nicht auf einen QUERY-Intent oder Berichtsstatus reagieren kann.
queryOnlyToggles	Boolesch	(Standard: false) Erforderlich, wenn das Gerät die Ausführung nur für Abfragen unterstützt. Dieses Attribut gibt an, ob vom Gerät nur Statusinformationen abgefragt und nicht gesteuert werden können.

Beispiele

Gerät mit Mehrfach-Ein-/Aus-Schaltfläche.

{
  "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 Ein-/Aus-Schaltflächen nur mit Befehl.

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

Gerät mit Ein-/Aus-Schaltflächen für Abfragen.

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

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
currentToggleSettings	Objekt	Erforderlich. Schlüssel/Wert-Paar mit der Ein-/Aus-Schaltfläche name des Geräts als Schlüssel und dem aktuellen Status als Wert.
<string>	Boolesch	Aktueller Status der Ein-/Aus-Schaltfläche.

Beispiele

Ist die Sterilisation eingeschaltet?

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

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

Legen Sie einen bestimmten Schalterstatus fest.

Parameter

Parameter	Typ	Beschreibung
updateToggleSettings	Objekt	Erforderlich. Schlüssel/Wert-Paar mit der Ein-/Aus-Schaltfläche name des Geräts als Schlüssel und dem neuen Status als Wert.
<string>	Boolesch	Neue Ein-/Aus-Schaltfläche

Beispiele

Aktiviere den Energiesparmodus.

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

de-DE

• Bitte schalte Power Cool am Kühlschrank aus
• stelle den Kühlschrank auf Power Cool

en-US

• activate power freeze for the freezer
• cancel power cool for the kitchen fridge

es-ES

• pon el enfriamiento rápido en la nevera
• quita el enfriamiento rápido

fr-FR

• mets le mode power cool sur le réfrigérateur
• Éteins le mode power freeze du réfrigérateur .

hi-IN

• रेफ़्रिजरेटर का पावर कूल मोड बंद कर दो
• रेफ़्रिजरेटर में पावर कूल मोड चालू करो

it-IT

• disattiva il power freeze del freezer
• imposta la funzione power freeze del surgelatore

ja-JP

• 冷蔵庫 の 急速冷凍 つけて
• 冷蔵庫 の 急速冷凍 を切ってくれる

ko-KR

• 냉장고 급속 냉장 해제해
• 냉장고 모드 급속 냉장 으로 바꿔

nl-NL

• Zet de power cool uit op de koelkast
• zet de koelkast op superkoelen

pt-BR

• Ativa a função power freeze no congelador .
• Desativa o bloqueio infantil do forno .
• desligar o power cool da geladeira
• iniciar o modo power freeze do freezer

sv-SE

• Stäng av power cool i kylskåpet
• sätt på power freeze på frysen

Gerät ERRORS

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