Schema der Eigenschaften von Smart-Home-Modi

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

Diese Eigenschaft gehört zu jedem Gerät mit einer beliebigen Anzahl von n-Wege-Modi, in denen die Modi und Einstellungen für jeden Modus beliebig und für jedes Gerät oder jeden Gerätetyp eindeutig sind. Für jeden Modus gibt es mehrere mögliche Einstellungen, es kann jedoch jeweils nur eine ausgewählt werden. Ein Trockner kann sich nicht gleichzeitig im Modus "Sensibel", "Normal" und "Hohe Leistung" befinden. Eine Einstellung, die einfach aktiviert oder deaktiviert werden kann, gehört zur Trait Toggles.

Bei einer Waschmaschine können beispielsweise Einstellungen für Wäschegröße und Temperatur vorgenommen werden. Beides sind Modi, weil sie unabhängig voneinander sind, aber jeder kann sich jeweils nur in einem Zustand befinden. Der Nutzer kann explizit einen Modus wie z. B. die Temperatur mit einem Befehl wie Stelle die Temperatur der Waschmaschine auf kalt festlegen.

Einige Modi sind „geordnet“ und können auch mit der Formulierung „Nach oben/unten“ oder „Verringern“ angepasst werden. Zum Beispiel sind Ladegröße (klein, mittel, groß) und Temperatur klar geordnet (beachten Sie, dass die Temperatur kein tatsächlicher Thermostat mit einem numerischen Ziel ist, wie bei anderen Geräten), aber der Ladetyp (schwierig, normal, Woll usw.) ist nicht unbedingt erforderlich.

Diese Trait umfasst einen oder mehrere individuelle Modi, die Nutzer festlegen können. Im Allgemeinen sollten diese Modi für Funktionen verwendet werden, die nicht mit anderen Geräteverhalten verbunden sind. Bei verknüpften Verhaltensmustern, z. B. beim Ein- oder Ausschalten des Geräts, sollten spezifischere Eigenschaften verwendet werden (z. B. thermostatMode in der 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
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. Diese Option ist möglicherweise nicht nutzerfreundlich und wird für alle 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 des 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 Artikel.

setting_name String

Erforderlich.

Interner Name der Moduseinstellung, der in Befehlen und Status verwendet wird. Diese Option ist möglicherweise nicht nutzerfreundlich und wird für alle Sprachen verwendet.

setting_values Array

Erforderlich.

Synonyme der Einstellung in den einzelnen 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

(Standard: false)

Wenn dies auf "true" gesetzt ist, wird zusätzliche Grammatik für die Erhöhung/Reduzierungslogik angewendet, und zwar in der Reihenfolge (Erhöhung) des Einstellungsarrays.

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

queryOnlyModes 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 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 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
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"
  }
}

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

Einstellungen für den Updatemodus.

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

Neu: setting_name.

Beispiele

Hohe Last festlegen:

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

Beispieläußerungen

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ät ERRORS

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