Smart Home Fill Trait-Schema

action.devices.traits.Fill: Dieses Merkmal gilt für Geräte, die befüllt werden können, z. B. eine Badewanne.

Geräteattribute

Geräte mit diesem Merkmal können die folgenden Attribute als Teil des Vorgangs SYNC melden. Weitere Informationen zum Umgang mit SYNC-Intents finden Sie unter Intent-Fulfillment.

Attribute Typ Beschreibung
availableFillLevels Objekt

Beschreibt verschiedene Füllstände des Geräts.
levels Array

Erforderlich.

Liste der Ebenennamen und sprachspezifischen Synonyme.
[item, ...] Objekt

Name der Stufe und die sprachspezifischen Synonyme.
level_name String

Erforderlich.

Interner Name der Stufe. Das ist nicht nutzerfreundlich und wird in allen Sprachen angezeigt.
level_values Array

Erforderlich.

Synonyme der Stufe in jeder unterstützten Sprache.
[item, ...] Objekt

Synonyme für die Stufe in einer bestimmten Sprache. Mindestens ein Artikel mit dem lang-Wert en ist erforderlich, um einen Sprach-Fallback zu ermöglichen.
level_synonym Array

Erforderlich.

Synonym für die Ebene. Der erste String in dieser Liste wird als kanonischer Name der Ebene in dieser Sprache verwendet.
[item, ...] String

Synonym name. Mindestens ein Artikel mit dem lang-Wert en ist erforderlich, um einen Sprach-Fallback zu ermöglichen.
lang String

Erforderlich.

Sprachcode (ISO 639-1). Unterstützte Sprachen
ordered Boolesch

Erforderlich.

Bei „true“ verarbeitet das Gerät zusätzliche Grammatik für die Logik zum Erhöhen oder Verringern, die durch das levels-Array dargestellt wird (z. B. halbe Stufe).
supportsFillPercent Boolesch

(Standardeinstellung: false)

Falls „true“, werden Befehle zum Anpassen des Pegels auf einen bestimmten Prozentsatz akzeptiert.

Beispiele

Gerät mit grundlegenden Funktionen zum Befüllen oder Entleeren, das keine diskreten Füllstände unterstützt.

{}

Gerät, das diskrete Füllstände 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ätestatus

Für Entitäten mit diesem Merkmal können im Rahmen des Vorgangs QUERY die folgenden Status gemeldet werden. Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Intent-Fulfillment.

Bundesstaaten Typ Beschreibung
isFilled Boolesch

Erforderlich.

„True“, wenn das Gerät bis zu einem beliebigen Pegel gefüllt ist. „False“, wenn der Akku des Geräts vollständig entladen ist.
currentFillLevel String

Erforderlich, wenn das Attribut availableFillLevels festgelegt ist. Gibt den aktuellen level_name aus dem Attribut availableFillLevels an, bis zu dem das Gerät gefüllt ist.
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 Ebenen)

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

GERÄTEBEFEHLE

Geräte mit diesem Merkmal können im Rahmen des Vorgangs EXECUTE auf die folgenden Befehle reagieren. Weitere Informationen zum Umgang mit EXECUTE-Intents finden Sie unter Intent-Fulfillment.

action.devices.commands.Fill

Gerät befüllen oder entleeren

Parameter

Parameter Typ Beschreibung
fill Boolesch

Erforderlich.

„True“ zum Befüllen, „false“ zum Entleeren.
fillLevel String

Gibt die level_name aus dem festzulegenden Attribut availableFillLevels an. Wenn nichts angegeben ist, wird bis zur Standardebene aufgefüllt.
fillPercent Number

Gibt den Prozentsatz des angeforderten Niveaus an.

Beispiele

Fülle die Badewanne.

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

Wasser aus der Badewanne lassen.

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

Fülle die Badewanne halbvoll.

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

Erhöhe den Füllstand 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