Schema für Smart-Home-Trait-Füllungen

action.devices.traits.Fill: Diese Eigenschaft gilt für Geräte, die das Befüllen unterstützen, z. B. eine Badewanne.

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
availableFillLevels	Objekt	Beschreibt die verschiedenen Füllstufen des Geräts.
levels	Array	Erforderlich. Liste der Ebenennamen und sprachspezifischen Synonyme.
[item, ...]	Objekt	Name der Stufe und die entsprechenden sprachspezifischen Synonyme.
level_name	String	Erforderlich. Interner Name der Stufe. Dies kann nicht nutzerfreundlich sein und wird in allen Sprachen verwendet.
level_values	Array	Erforderlich. Synonyme der Stufe in jeder unterstützten Sprache.
[item, ...]	Objekt	Synonyme des Levels in einer bestimmten Sprache.
level_synonym	Array	Erforderlich. Synonym für 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 Logik zum Erhöhen oder Verringern, wie durch das levels-Array dargestellt (z. B. halbe Ebene).
supportsFillPercent	Boolesch	(Standardeinstellung: false) Falls wahr, werden Befehle zum Anpassen des Pegels in Prozent angenommen.

Beispiele

Gerät mit Basisfunktion zum Befüllen oder Entladen, das keine einzelnen Füllstufen unterstützt.

{}

Gerät, das diskrete 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 Merkmal melden möglicherweise Folgendes: QUERY-Bundesstaaten. Weitere Informationen Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Absichtliche Umsetzung.

Bundesstaaten	Typ	Beschreibung
isFilled	Boolesch	Erforderlich. „True“, wenn das Gerät gefüllt ist. Falsch, wenn das Gerät vollständig entladen ist.
currentFillLevel	String	Erforderlich, wenn das Attribut availableFillLevels festgelegt ist. Gibt die aktuelle level_name aus dem Attribut availableFillLevels an, mit der das Gerät ausgefüllt wird.
currentFillPercent	Number	Erforderlich, wenn das Attribut supportsFillPercent festgelegt ist. Gibt den aktuellen Füllstand in Prozent an.

Beispiele

Ist die Badewanne gefüllt?

{
  "isFilled": true
}

Ist die Badewanne gefüllt? (mit Stufen)

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

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

Befüllen Sie das Gerät oder lassen Sie es ab.

Parameter

Parameter	Typ	Beschreibung
fill	Boolesch	Erforderlich. True für Füllung, false für Drain.
fillLevel	String	Gibt die level_name aus dem festzulegenden availableFillLevels-Attribut an. Wenn kein Wert angegeben ist, wird das Objekt auf die Standardebene ausgefüllt.
fillPercent	Number	Gibt den angeforderten Stufenprozentsatz 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 zur Hälfte aus.

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

Erhöhung des Füllstands in der Badewanne um eins (Attribut ordered muss true sein).

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

Gerätefehler

Vollständige Liste der Fehler und Ausnahmen.