Schema der Smart-Home-Füllung

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

Geräte-ATTRIBUTE

Geräte mit diesem Merkmal können im Rahmen des SYNC-Vorgangs die folgenden Attribute melden. Weitere Informationen zum Verarbeiten von SYNC-Intents finden Sie unter Intent-Auftragsausführung.

Attribute	Typ	Beschreibung
availableFillLevels	Objekt	Beschreibt verschiedene Ebenen der Füllung des Geräts.
levels	Array	Erforderlich. Liste der Ebenennamen und sprachspezifischen Synonyme.
[item, ...]	Objekt	Name der Stufe und ihre sprachspezifischen Synonyme.
level_name	String	Erforderlich. Interner Name der Ebene. Das Spiel kann nicht nutzerfreundlich sein und wird in allen Sprachen verwendet.
level_values	Array	Erforderlich. Synonyme der Ebene in jeder unterstützten Sprache.
[item, ...]	Objekt	Synonyme der Ebene in einer bestimmten Sprache.
level_synonym	Array	Erforderlich. Synonym für das Niveau. Der erste String in dieser Liste wird als kanonischer Name der Ebene in der betreffenden Sprache verwendet.
[item, ...]	String	Synonym name.
lang	String	Erforderlich. Sprachcode (ISO 639-1). Siehe unterstützte Sprachen
ordered	Boolesch	Erforderlich. Bei „true“ verarbeitet das Gerät zusätzliche Grammatik zur Erhöhung oder Verringerung der Logik, wie durch das Array levels dargestellt (z. B. Halbebene).
supportsFillPercent	Boolesch	(Standard: false) Bei „true“ werden Befehle zum Einstellen des Levels auf einen Prozentsatz akzeptiert.

Beispiele

Gerät mit grundlegenden Füll- oder Draining-Funktionen, die keine getrennten Füllebenen unterstützen.

{}

Gerät, das bestimmte Ausführungsraten 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 Merkmal können im Rahmen des QUERY-Vorgangs die folgenden Status melden: Weitere Informationen zum Verarbeiten von QUERY-Intents finden Sie unter Intent-Auftragsausführung.

Bundesstaaten	Typ	Beschreibung
isFilled	Boolesch	Erforderlich. Dieser Wert ist „True“, wenn das Gerät auf einer beliebigen Ebene gefüllt ist. „False“, wenn der Akku des Geräts vollständig entladen ist.
currentFillLevel	String	Erforderlich, wenn das Attribut availableFillLevels festgelegt ist. Gibt das aktuelle level_name aus dem availableFillLevels-Attribut an, mit dem das Gerät gefüllt ist.
currentFillPercent	Number	Erforderlich, wenn das Attribut supportsFillPercent festgelegt ist. Gibt den aktuellen Prozentsatz der Ausführungsrate an.

Beispiele

Ist die Badewanne gefüllt?

{
  "isFilled": true
}

Ist die Badewanne gefüllt? (mit Stufen).

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

BEISPIELE für Geräte

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

action.devices.commands.Fill

Füllen oder entladen Sie das Gerät.

Parameter

Parameter	Typ	Beschreibung
fill	Boolesch	Erforderlich. True zum Füllen, False zum Draining.
fillLevel	String	Gibt das level_name aus dem festzulegenden availableFillLevels-Attribut an. Wenn keine Angabe erfolgt, wird die Standardebene verwendet.
fillPercent	Number	Gibt den angeforderten Level in Prozent an.

Beispiele

Fülle die Badewanne aus.

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

Abfluss der Badewanne

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

Fülle die Badewanne in der Mitte aus.

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

Erhöhen Sie die Badewannenfüllung um eins (Attribut ordered muss true lauten).

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

Gerät ERRORS

Hier finden Sie die vollständige Liste der Fehler und Ausnahmen.