Schema für Smart-Home-Modi

action.devices.traits.Modes: Diese Eigenschaft deckt alle verfügbaren Modi und modusspezifischen Einstellungen für ein Gerät ab.

Dieses Merkmal gehört zu allen Geräten mit einer beliebigen Anzahl von „n-Wege“-Verbindungen Modi, in denen der Modi und Einstellungen für jeden Modus beliebig und für jedes Gerät oder jeden Gerätetyp einzigartig. Für jeden Modus gibt es mehrere mögliche Einstellungen, es kann aber jeweils nur eine ausgewählt werden. kann ein Trockner „empfindlich“ sein, „Normal“, und „Heavy Duty“ zu wechseln. Eine Einstellung, die einfach aktiviert oder deaktiviert werden kann, gehört zum Trait „Toggles“.

Beispielsweise können für eine Waschmaschine Einstellungen für die Ladungsgröße und die Temperatur festgelegt werden. Beides wären Modi, weil sie unabhängig voneinander sind, aber jeder kann jeweils nur einen Status haben. Der Nutzer kann einen Modus festlegen wie mit einem Befehl wie Stelle die Temperatur der Waschmaschine auf kalt.

Einige Modi sind „sortiert“ und können mit den Tasten "Nach oben" und "Nach unten" den Wortlaut erhöhen/verringern. Zum Beispiel die Ladegröße (klein, mittel, groß) und Temperatur sind klar angeordnet (beachten Sie, dass die Temperatur keine tatsächliche mit einem numerischen Zielwert, wie bei anderen Geräten), aber Lasttyp (Feinkost, normal, Wolle usw.) möglicherweise nicht.

Dieses Merkmal deckt einen oder mehrere einzelne Modi ab, die Nutzer festlegen können. Im Allgemeinen Diese Modi sollten für Funktionen verwendet werden, die nicht mit anderen Geräten verknüpft sind verhalten. Verknüpfte Verhaltensweisen, wie das Ein- oder Ausschalten des Geräts, sollten spezifischere Merkmale verwenden (z. B. die 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
availableModes Array

Erforderlich.

Liste der verfügbaren Modi.
[item, ...] Objekt

Verfügbarer Modus.
name String

Erforderlich.

Interner Name des Modus, der in Befehlen und Status verwendet wird. Dies kann nicht nutzerfreundlich sein und wird in allen Sprachen verwendet.
name_values Array

Erforderlich.

Synonyme für den Modus in den einzelnen unterstützten Sprachen.
[item, ...] Objekt

Synonyme des Modus in einer bestimmten Sprache.
name_synonym Array

Erforderlich.

Synonyme für den Modus. 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
settings Array

Erforderlich.

Unterstützte Einstellungen für diesen Modus.
[item, ...] Objekt

Unterstützte Einstellung.

Erfordert mindestens 2 Elemente.
setting_name String

Erforderlich.

Interner Name der Moduseinstellung, die in Befehlen und Status verwendet wird. Dies kann nicht nutzerfreundlich sein und wird in allen Sprachen verwendet.
setting_values Array

Erforderlich.

Synonyme der Einstellung in den unterstützten Sprachen.
[item, ...] Objekt

Synonyme der Einstellung in einer bestimmten Sprache.
setting_synonym Array

Erforderlich.

Synonyme der Einstellung. 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
ordered Boolesch

(Standardeinstellung: false)

Wenn dies auf „true“ gesetzt ist, wird zusätzliche Grammatik für die Logik zum Erhöhen/Verringern in der Reihenfolge (Erhöhung) des Arrays „settings“ angewendet.
commandOnlyModes 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.
queryOnlyModes 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 Modi und Einstellungen

{
  "availableModes": [
    {
      "name": "load_mode",
      "name_values": [
        {
          "name_synonym": [
            "Load",
            "Size",
            "Load size"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "small_load",
          "setting_values": [
            {
              "setting_synonym": [
                "Small",
                "Half"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "medium_load",
          "setting_values": [
            {
              "setting_synonym": [
                "Medium",
                "Normal"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "large_load",
          "setting_values": [
            {
              "setting_synonym": [
                "Large",
                "Full"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": true
    },
    {
      "name": "temp_mode",
      "name_values": [
        {
          "name_synonym": [
            "Temperature",
            "Temp"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "hot_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "Hot",
                "White"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "warm_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "Warm",
                "Color"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "cold_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "Cold",
                "Delicate"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": false
    }
  ]
}

Gerät mit Nur-Befehl-Modi.

{
  "availableModes": [
    {
      "name": "light_mode",
      "name_values": [
        {
          "name_synonym": [
            "Light",
            "Lighting"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "day_light",
          "setting_values": [
            {
              "setting_synonym": [
                "Day",
                "Bright"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "night_light",
          "setting_values": [
            {
              "setting_synonym": [
                "Night",
                "Dark"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "reading_light",
          "setting_values": [
            {
              "setting_synonym": [
                "Reading",
                "Ambiant"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": false
    }
  ],
  "commandOnlyModes": true,
  "queryOnlyModes": false
}

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
currentModeSettings Objekt

Erforderlich.

Schlüssel/Wert-Paar mit dem Modus name des Geräts als Schlüssel und dem aktuellen setting_name als Wert.
<string> String

Aktuell: setting_name.

Beispiele

In welchem Modus befindet sich das Gerät?

{
  "currentModeSettings": {
    "load_mode": "small_load",
    "temp_mode": "cold_temp"
  }
}

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

Einstellungen für den Aktualisierungsmodus.

Parameter

Parameter Typ Beschreibung
updateModeSettings Objekt

Erforderlich.

Schlüssel/Wert-Paar mit dem Modus name des Geräts als Schlüssel und dem neuen setting_name als Wert.
<string> String

Neue setting_name.

Beispiele

Auf hohe Last festgelegt.

{
  "command": "action.devices.commands.SetModes",
  "params": {
    "updateModeSettings": {
      "load_mode": "large_load"
    }
  }
}

Beispieläußerungen

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

de-DE

  • Stelle den Staubsauger auf Ruhemodus

en-US

  • set the vacuum to energy saver mode

es-ES

  • pon la lavadora en modo frío

fr-FR

  • mets l'aspirateur en silencieux

hi-IN

  • वैक्यूम पर कार्पेट मोड लगाएं

it-IT

  • imposta l'aspirapolvere su silenzioso

ja-JP

  • 掃除機 を 静音 モードに設定して

ko-KR

  • 세탁기 세탁량 많음 으로 설정해

pt-BR

  • acionar a função autolimpeza do aspirador
  • ligar o modo de aquecimento

Gerätefehler

Vollständige Liste der Fehler und Ausnahmen.