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.