Willkommen beim Google Home Developer Center, der neuen Anlaufstelle für Smart-Home-Aktionen. Hinweis:Sie erstellen weiterhin Aktionen in der Actions Console.
Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Schema der Smart-Home-Füllung

action.devices.traits.Fill: Dieses Merkmal gilt für Geräte, die das Ausfüllen erleichtern, z. B. eine Badewanne.

Gerät ATTRIBUTE

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

Attribute Typ Beschreibung
availableFillLevels Objekt

Beschreibt verschiedene Füllebenen für das Gerät.

levels Array

Erforderlich.

Liste von Levelnamen und sprachspezifischen Synonymen.

[item, ...] Objekt

Name der Stufe und ihre sprachspezifischen Synonyme

level_name String

Erforderlich.

Interner Name der Ebene. Diese Funktion kann nicht nutzerfreundlich sein und wird in allen Sprachen verwendet.

level_values Array

Erforderlich.

Synonyme des Levels in den einzelnen unterstützten Sprachen.

[item, ...] Objekt

Synonyme des Levels in einer bestimmten Sprache.

level_synonym Array

Erforderlich.

Synonym für „Level“. 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) Siehe unterstützte Sprachen.

ordered Boolesch

Erforderlich.

Wenn „true“ festgelegt ist, verarbeitet das Gerät zusätzliche Grammatik für die Logik zur Erhöhung oder Verringerung, die durch das Array levels dargestellt wird (z. B. halbe Ebene).

supportsFillPercent Boolesch

(Standard: false)

Wenn der Wert „true“ ist, akzeptieren Sie Befehle, um die Stufe auf einen Prozentsatz einzustellen.

Beispiele

Gerät mit grundlegenden Füll- oder Drain-Funktionen, die keine separaten Ausführungsraten unterstützen.

{}

Gerät, das diskrete 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ät STATES

Geräte mit diesem Attribut können im Rahmen des Vorgangs QUERY die folgenden Zustände melden. Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Intent-Auftragsausführung.

Bundesstaaten Typ Beschreibung
isFilled Boolesch

Erforderlich.

Wahr, wenn das Gerät auf eine beliebige Ebene gefüllt ist. Falsch, wenn das Gerät vollständig entladen ist.

currentFillLevel String

Erforderlich, wenn das Attribut availableFillLevels festgelegt ist. Gibt das aktuelle level_name aus dem Attribut availableFillLevels 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 Levels).

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

Gerätebefehle

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

action.devices.commands.Fill

Fülle das Gerät oder entlere es.

Parameter

Parameter Typ Beschreibung
fill Boolesch

Erforderlich.

True zum Füllen, False zum Drain.

fillLevel String

Gibt die level_name aus dem festzulegenden availableFillLevels-Attribut an. Wenn nicht angegeben, füllen Sie die Standardebene aus.

fillPercent Number

Gibt den angeforderten Prozentsatz in Prozent an.

Beispiele

Fülle die Badewanne aus.

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

Die Badewanne wird geleert.

{
  "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 die Badewannenfüllung um eins (Attribut ordered muss true sein).

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

Gerät ERRORS

Vollständige Liste der Fehler und Ausnahmen