Smart Home wechselt das Trait-Schema um

action.devices.traits.Toggles: Dieser Trait gehört zu allen Geräten, deren Einstellungen nur in einem von zwei Status vorliegen können.

Bei diesen Einstellungen kann es sich um eine physische Schaltfläche mit dem Status „An/Aus“ oder „Aktiv/Inaktiv“ handeln. Status, ein Kontrollkästchen in HTML oder eine andere Art speziell aktiviert/deaktiviert -Elements. Wenn die Einstellung mehr als zwei Status hat oder einen Status hat, keine der binären Optionen ausgewählt ist, sollte sie besser als Modes-Trait, was den Wahlmöglichkeiten in mehreren Bundesstaaten entspricht, Optionsfelder (physisch oder HTML) oder binäre Statuswerte, die nicht explizit ein/aus (z. B. "AM/FM" oder "heiß/kalt").

Dieses Merkmal umfasst eine oder mehrere einzelne Ein-/Aus-Schaltflächen, die Nutzer festlegen können. In Im Allgemeinen sollten diese Ein-/Aus-Schaltflächen für Funktionen verwendet werden, die nicht verknüpft sind. vom anderen Geräteverhalten beeinflusst. Verknüpftes Verhalten, z. B. Drehen des Geräts aktiviert oder deaktiviert, sollte spezifischere Merkmale verwenden (z. B. thermostatMode im Trait TemperatureSetting).

Geräte-ATTRIBUTES

Auf Geräten mit diesem Trait kann Folgendes gemeldet werden im Rahmen des SYNC-Vorgangs verwenden. Weitere Informationen Weitere Informationen zum Umgang mit SYNC-Intents finden Sie unter Absichtliche Umsetzung.

Attribute Typ Beschreibung
availableToggles Array

Erforderlich.

Liste der verfügbaren Ein-/Aus-Schaltflächen.
[item, ...] Objekt

Verfügbare Ein/Aus-Schaltfläche.
name String

Erforderlich.

Interner Name der Ein/Aus-Schaltfläche, der in Befehlen und Status verwendet wird. Dies kann nicht nutzerfreundlich sein und wird in allen 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 der 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

(Standardeinstellung: false)

Gibt an, ob das Gerät die unidirektionale (wahr) oder bidirektionale (falsche) Kommunikation unterstützt. Setzen Sie dieses Attribut auf „true“, wenn das Gerät nicht auf einen QUERY-Intent oder „Report State“ für dieses Merkmal reagieren kann.
queryOnlyToggles Boolesch

(Standardeinstellung: false)

Erforderlich, wenn das Gerät die ausschließliche Ausführung von Abfragen unterstützt. Dieses Attribut gibt an, ob das Gerät nur Statusinformationen abgefragt werden kann und nicht gesteuert werden kann.

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 Ein-/Aus-Schaltflächen nur für Befehle.

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

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

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

Gerät: STATES

Entitäten mit diesem Merkmal melden möglicherweise Folgendes: QUERY-Bundesstaaten. Weitere Informationen Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Absichtliche Umsetzung.

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

Beispiele

Ist die Sterilisierung aktiviert?

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

Gerät "COMMANDS"

Geräte mit diesem Merkmal können auf Folgendes reagieren im Rahmen des EXECUTE-Vorgangs ausgeführt. Weitere Informationen Weitere Informationen zum Umgang mit EXECUTE-Intents finden Sie unter Absichtliche Umsetzung.

action.devices.commands.SetToggles

Legt einen bestimmten Umschaltstatus 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

Neuer Ein-/Aus-Status

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

<ph type="x-smartling-placeholder">

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ätefehler

Vollständige Liste der Fehler und Ausnahmen.