Smart-Home-Füllelement-Schema

action.devices.traits.Fill: Diese Eigenschaft gilt für Geräte, die mit Wasser gefüllt werden können, z. B. eine Badewanne.

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
availableFillLevels	Objekt	Beschreibt die verschiedenen Füllungen des Geräts.
levels	Array	Erforderlich. Liste der Stufennamen und sprachspezifischen Synonyme.
[item, ...]	Objekt	Name der Stufe und ihre sprachspezifischen Synonyme.
level_name	String	Erforderlich. Interner Name der Ebene. Diese Option ist möglicherweise nicht nutzerfreundlich und wird für alle Sprachen verwendet.
level_values	Array	Erforderlich. Synonyme für das Niveau in den einzelnen unterstützten Sprachen.
[item, ...]	Objekt	Synonyme des Niveaus in einer bestimmten Sprache
level_synonym	Array	Erforderlich. Synonym der Stufe. 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	Erforderlich. Bei „true“ verarbeitet das Gerät zusätzliche Grammatik für die Erhöhung oder Verringerung der Logik, wie sie durch das levels-Array dargestellt wird (z. B. auf halber Ebene).
supportsFillPercent	Boolesch	(Standard: false) Wenn „true“, werden Befehle zum Anpassen des Niveaus auf einen Prozentsatz akzeptiert.

Beispiele

Gerät mit grundlegender Füll- oder Entladungsfunktion, das keine einzelnen Füllwerte unterstützt.

{}

Gerät, das separate Füllstufen unterstützt

{
  "availableFillLevels": {
    "levels": [
      {
        "level_name": "half_level",
        "level_values": [
          {
            "level_synonym": [
              "Half",
              "Half way",
              "One half"
            ],
            "lang": "en"
          }
        ]
      },
      {
        "level_name": "full_level",
        "level_values": [
          {
            "level_synonym": [
              "Full",
              "All the way",
              "Complete"
            ],
            "lang": "en"
          }
        ]
      }
    ],
    "ordered": 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
isFilled	Boolesch	Erforderlich. „True“, wenn das Gerät eine beliebige Füllung erreicht hat. "False", wenn das Gerät vollständig entladen ist.
currentFillLevel	String	Erforderlich, wenn das Attribut availableFillLevels festgelegt ist. Gibt den aktuellen Wert für „level_name“ aus dem Attribut „availableFillLevels“ an, mit dem das Gerät gefüllt wird.
currentFillPercent	Number	Erforderlich, wenn das Attribut supportsFillPercent festgelegt ist. Gibt den aktuellen Prozentsatz der Füllung an.

Beispiele

Ist die Badewanne voll?

{
  "isFilled": true
}

Ist die Badewanne voll? (mit Stufen).

{
  "isFilled": true,
  "currentFillLevel": "half_level"
}

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

Füllen Sie das Gerät auf oder entleeren Sie es.

Parameter

Parameter	Typ	Beschreibung
fill	Boolesch	Erforderlich. „True“ zum Füllen, „false“ zum Entladen.
fillLevel	String	Gibt das festzulegende level_name-Attribut aus dem availableFillLevels-Attribut an. Wenn nicht angegeben, füllen Sie die Standardebene aus.
fillPercent	Number	Gibt den angeforderten Prozentsatz an.

Beispiele

Badewanne füllen

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true
  }
}

Lass die Badewanne ab.

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": false
  }
}

Fülle die Badewanne halb voll.

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true,
    "fillLevel": "half_level"
  }
}

Erhöhen Sie den Füllstand der Badewanne um eins (Attribut ordered muss true sein).

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true,
    "fillLevel": "full_level"
  }
}

Gerät ERRORS

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