Schema von Smart-Home-Kocheigenschaften
action.devices.traits.Cook
: Diese Trait gehört zu Geräten, mit denen Essen anhand verschiedener Voreinstellungen und unterstützter Kochmodi zubereitet werden kann.
Beispiele für diese Gerätetypen sind Multicooker, Pressure cooker, Blender und Microwave. Kochbefehle können die Menge und den Namen des Essens enthalten, z. B. „Zwei Tassen brauner Reis“, wobei „brauner Reis“ eine Lebensmittelvoreinstellung für das Gerät ist.
Diese Eigenschaft hat keinen Einfluss auf die Garzeit oder Gartemperatur. Weitere Informationen finden Sie unter Timer und TemperatureControl.
Geräte-ATTRIBUTE
Geräte mit dieser Eigenschaft melden möglicherweise die folgenden Attribute im Rahmen des SYNC
-Vorgangs. Weitere Informationen zum Umgang mit SYNC
-Intents finden Sie unter Intent-Auftragsausführung.
Attribute | Typ | Beschreibung |
---|---|---|
supportedCookingModes |
Array |
Erforderlich. Von diesem Gerät unterstützte Kochmodi. |
[item, ...] |
String |
Kochmodus. Unterstützte Werte:
|
foodPresets |
Array |
Voreinstellungen für bestimmte Lebensmittel |
[item, ...] |
Objekt |
Voreinstellung „Lebensmittel“. |
food_preset_name |
String |
Erforderlich. Interner Name der Lebensmittelvoreinstellung, der in Befehlen und Status verwendet wird. Dieser Name ist möglicherweise nicht nutzerfreundlich und wird für alle Sprachen verwendet. |
supported_units |
Array |
Erforderlich. Enthält alle Einheiten, die vom Gerät für ein bestimmtes Lebensmittel unterstützt werden. |
[item, ...] |
String |
Unterstützte Einheit. Unterstützte Werte:
|
food_synonyms |
Array |
Erforderlich. Synonyme für Lebensmittelnamen für die Voreinstellung in jeder unterstützten Sprache. |
[item, ...] |
Objekt |
Name des Lebensmittels. |
synonym |
Array |
Erforderlich. Synonyme für die Voreinstellung; sollten gegebenenfalls sowohl Singular- als auch Pluralformen enthalten. |
[item, ...] |
String |
Name des voreingestellten Synonyms. |
lang |
String |
Erforderlich. Sprachcode (ISO 639-1). Weitere Informationen zu unterstützten Sprachen |
Beispiele
Gerät mit nur einem Kochmodus und ohne Voreinstellung.
{ "supportedCookingModes": [ "BAKE" ] }
Gerät mit mehreren Kochmodi und Voreinstellungen
{ "supportedCookingModes": [ "COOK", "WARM" ], "foodPresets": [ { "food_preset_name": "white_rice", "supported_units": [ "CUPS" ], "food_synonyms": [ { "synonym": [ "White Rice", "Rice" ], "lang": "en" } ] }, { "food_preset_name": "brown_rice", "supported_units": [ "CUPS" ], "food_synonyms": [ { "synonym": [ "Brown Rice" ], "lang": "en" } ] } ] }
Gerät STATES
Entitäten mit diesem Trait können die folgenden Status im Rahmen des QUERY
-Vorgangs melden. Weitere Informationen zum Umgang mit QUERY
-Intents finden Sie unter Intent-Auftragsausführung.
Bundesstaaten | Typ | Beschreibung |
---|---|---|
currentCookingMode |
String |
Erforderlich. Beschreibt den aktuell auf dem Gerät eingestellten Kochmodus anhand der Liste des |
currentFoodPreset |
String |
Beschreibt das Kochen von Speisen auf dem Gerät anhand der Liste des Attributs |
currentFoodQuantity |
Number |
Definiert die aktuelle Zubereitungsmenge von Lebensmitteln, die mit |
currentFoodUnit |
String |
Die Einheit, die mit |
Beispiele
Wird mein Ofen gekocht?
{ "currentCookingMode": "BAKE" }
Was kocht gerade in meinem Reiskocher?
{ "currentCookingMode": "COOK", "currentFoodPreset": "brown_rice", "currentFoodQuantity": 2, "currentFoodUnit": "CUPS" }
BEFEHLUNGEN auf dem Gerät
Geräte mit dieser Eigenschaft können im Rahmen des EXECUTE
-Vorgangs auf die folgenden Befehle reagieren. Weitere Informationen zum Umgang mit EXECUTE
-Intents finden Sie unter Intent-Auftragsausführung.
action.devices.commands.Cook
Mit dem Kochen beginnen oder aufhören.
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
start |
Boolesch |
Erforderlich. "True", um mit dem Kochen zu beginnen, "false", um den aktuellen Kochmodus zu beenden. |
cookingMode |
String |
Der Kochmodus für das Gerät wurde über das Attribut |
foodPreset |
String |
Der Name der Lebensmittelvoreinstellung, die vom Nutzer aus dem Attribut |
quantity |
Number |
Die vom Nutzer angeforderte Menge der Lebensmittel. |
unit |
String |
Die Einheit, die mit dem Attribut „ |
Beispiele
Anfang im Ofen zu backen.
{ "command": "action.devices.commands.Cook", "params": { "start": true, "cookingMode": "BAKE" } }
Hör auf, in meinem Ofen zu backen.
{ "command": "action.devices.commands.Cook", "params": { "start": false, "cookingMode": "BAKE" } }
Fang in meinem Reiskocher damit an, 2 Tassen weißen Reis zu kochen.
{ "command": "action.devices.commands.Cook", "params": { "start": true, "cookingMode": "COOK", "foodPreset": "white_rice", "quantity": 2, "unit": "CUPS" } }
Gerät ERRORS
Sehen Sie sich die vollständige Liste der Fehler und Ausnahmen an.deviceDoorOpen
: Die Gerätetür ist offen.deviceLidOpen
– Der Deckel des Geräts ist offen.fractionalAmountNotSupported
: Der Nutzer hat einen Teilbetrag für diese Voreinstellung angefordert, die aber auf diesem Gerät nicht unterstützt wird.amountAboveLimit
: Der Nutzer hat eine Menge angefordert, die über dem Höchstwert lag.unknownFoodPreset
: Der Nutzer hat eine Lebensmittelvoreinstellung angefordert, die vom Gerät nicht unterstützt wird.