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 |
supportsFillPercent |
Boolesch |
(Standard: 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 |
currentFillPercent |
Number |
Erforderlich, wenn das Attribut |
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 |
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" } }