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 unterstützt, z. B. eine Badewanne.

ATTRIBUTE DES Geräts

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 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. Diese Datei ist nicht nutzerfreundlich und wird in allen Sprachen verwendet.

level_values Array

Erforderlich.

Synonyme der Ebene in jeder unterstützten Sprache.

[item, ...] Objekt

Synonyme des Levels in einer bestimmten Sprache.

level_synonym Array

Erforderlich.

Synonym für das 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). Weitere Informationen

ordered Boolesch

Erforderlich.

Wenn der Wert „true“ ist, verarbeitet das Gerät zusätzliche Grammatik zur Erhöhung oder Verringerung der Logik, wie durch das Array levels dargestellt (z. B. die Hälfte).

supportsFillPercent Boolesch

(Standard: false)

Wenn der Wert „true“ ist, akzeptieren Sie Befehle zum Einstellen der Prozentzahl.

Beispiele

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

{}

Gerät, das unterschiedliche Füllraten 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 Status melden. Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Intent-Auftragsausführung.

Bundesstaaten Typ Beschreibung
isFilled Boolesch

Erforderlich.

Dieser Wert ist „True“, wenn das Gerät auf jeder Ebene gefüllt ist. „False“, wenn das Gerät vollständig entladen ist.

currentFillLevel String

Erforderlich, wenn das Attribut availableFillLevels festgelegt ist. Gibt die 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 Ebenen).

{
  "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 aus oder lass es ab.

Parameter

Parameter Typ Beschreibung
fill Boolesch

Erforderlich.

Richtig: Füllung, False bis Drain.

fillLevel String

Gibt das festzulegende level_name aus dem Attribut availableFillLevels an. Falls nicht angegeben, füllen Sie die Standardebene aus.

fillPercent Number

Gibt den angeforderten Prozentwert 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