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äteattribute

Geräte mit dieser Eigenschaft können die folgenden Attribute im Rahmen des Vorgangs SYNC melden. Weitere Informationen zum Umgang mit SYNC-Intents finden Sie unter Intent-Ausführung.

Attribute Typ Beschreibung
availableFillLevels Objekt

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

Erforderlich.

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

Der Stufenname und seine sprachspezifischen Synonyme.
level_name String

Erforderlich.

Interner Name der Stufe. Das kann für Nutzer nicht nutzerfreundlich sein und wird in allen Sprachen verwendet.
level_values Array

Erforderlich.

Synonyme für das Level in jeder unterstützten Sprache.
[item, ...] Objekt

Synonyme für das Level in einer bestimmten Sprache.
level_synonym Array

Erforderlich.

Synonyme der Ebene. Der erste String in dieser Liste wird als kanonischer Name des Levels in dieser Sprache verwendet.
[item, ...] String

Name des Synonymes.
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, wie durch das levels-Array dargestellt (z. B. halbe Ebene).
supportsFillPercent Boolesch

(Standardeinstellung: false)

Wenn diese Option aktiviert ist, werden Befehle zum Anpassen des Pegels auf einen Prozentsatz akzeptiert.

Beispiele

Gerät mit grundlegenden Füll- oder Entladefunktionen, 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

Entitäten mit diesem Attribut können im Rahmen des Vorgangs QUERY die folgenden Status melden. Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Intent-Ausführung.

Bundesstaaten Typ Beschreibung
isFilled Boolesch

Erforderlich.

„True“, wenn das Gerät gefüllt ist. „False“, wenn das Gerät vollständig entladen ist.
currentFillLevel String

Erforderlich, wenn das Attribut availableFillLevels festgelegt ist. Gibt den aktuellen level_name aus dem availableFillLevels-Attribut an, mit dem 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 Ebenen).

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

BEFEHLE für Geräte

Geräte mit dieser Eigenschaft können im Rahmen des Vorgangs EXECUTE auf die folgenden Befehle reagieren. Weitere Informationen zum Umgang mit EXECUTE-Intents finden Sie unter Intent-Ausführung.

action.devices.commands.Fill

Füllen oder entleeren Sie das Gerät.

Parameter

Parameter Typ Beschreibung
fill Boolesch

Erforderlich.

„True“ (wahr), um zu füllen, „false“ (falsch), um zu entleeren.
fillLevel String

Gibt den Wert für level_name aus dem Attribut availableFillLevels an, der festgelegt werden soll. Wenn keine Angabe erfolgt, wird der Standardwert verwendet.
fillPercent Number

Gibt den angeforderten Stufenprozentsatz an.

Beispiele

Füllen Sie die Badewanne.

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

Lassen Sie das Wasser aus der Badewanne ablaufen.

{
  "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ö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ÄTEFEHLER

Vollständige Liste der Fehler und Ausnahmen