Schema von Smart Home Cook Trait
action.devices.traits.Cook
: Diese Eigenschaft gehört zu Geräten, die Lebensmittel anhand verschiedener Lebensmittelvoreinstellungen und unterstützter Kochmodi kochen können.
Beispiele für diese Gerätetypen sind Multikocher, Schnellkocher, Mixer und Mikrowelle. Kochbefehle können die Menge und den Namen des Essens enthalten, z. B. „Zwei Tassen brauner Reis“, wobei „brauner Reis“ eine Voreinstellung für das Gerät ist.
Diese Eigenschaft verarbeitet die Garzeit oder Kochtemperatur nicht. Weitere Informationen finden Sie unter Timer und Temperaturregler.
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 |
---|---|---|
supportedCookingModes |
Array |
Erforderlich. Von diesem Gerät unterstützte Kochmodi |
[item, ...] |
String |
Kochmodus. Unterstützte Werte:
|
foodPresets |
Array |
Voreinstellungen für bestimmte Arten von Speisen |
[item, ...] |
Objekt |
Lebensmittelvoreinstellung. |
food_preset_name |
String |
Erforderlich. Interner Name der Lebensmittelvoreinstellung, der in Befehlen und Status verwendet wird. Dieser Name kann nicht nutzerfreundlich sein und wird in allen Sprachen verwendet. |
supported_units |
Array |
Erforderlich. Enthält alle Einheiten, die vom Gerät für ein bestimmtes Essen 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 |
Lebensmittelname. |
synonym |
Array |
Erforderlich. Synonyme für die Voreinstellung sollten sowohl Singular- als auch Pluralformen enthalten, falls zutreffend. |
[item, ...] |
String |
Voreingestellter Synonymname. |
lang |
String |
Erforderlich. Sprachcode (ISO 639-1) Siehe unterstützte Sprachen. |
Beispiele
Gerät mit nur einem Kochmodus und ohne Voreinstellung
{ "supportedCookingModes": [ "BAKE" ] }
Gerät mit mehreren Kochmodi und Lebensmittelvoreinstellungen
{ "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
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 |
---|---|---|
currentCookingMode |
String |
Erforderlich. Beschreibt den aktuellen Kochmodus, der aus der Liste der |
currentFoodPreset |
String |
Beschreibt die aktuelle Zubereitung aus dem Gerät in der Liste der |
currentFoodQuantity |
Number |
Definiert die aktuelle Menge des mit dem |
currentFoodUnit |
String |
Die mit dem Attribut „ |
Beispiele
Wird im Ofen gekocht?
{ "currentCookingMode": "BAKE" }
Was kocht gerade in meinem Reiskocher?
{ "currentCookingMode": "COOK", "currentFoodPreset": "brown_rice", "currentFoodQuantity": 2, "currentFoodUnit": "CUPS" }
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.Cook
Kochen oder beenden Sie das Kochen.
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
start |
Boolesch |
Erforderlich. True, um mit dem Kochen zu beginnen, False, um den aktuellen Kochmodus zu beenden. |
cookingMode |
String |
Kochmodus des Geräts wurde über das Attribut |
foodPreset |
String |
Der Name der Voreinstellung, die der Nutzer vom Attribut „ |
quantity |
Number |
Die Menge des Essens, die der Nutzer angefordert hat. |
unit |
String |
Die mit dem Attribut „ |
Beispiele
Backe in meinen Ofen.
{ "command": "action.devices.commands.Cook", "params": { "start": true, "cookingMode": "BAKE" } }
Beende das Backen in meinem Ofen.
{ "command": "action.devices.commands.Cook", "params": { "start": false, "cookingMode": "BAKE" } }
Beginne mit der Zubereitung von 2 Tassen weißen Reis in meinem Reiskocher.
{ "command": "action.devices.commands.Cook", "params": { "start": true, "cookingMode": "COOK", "foodPreset": "white_rice", "quantity": 2, "unit": "CUPS" } }
Gerät ERRORS
Vollständige Liste der Fehler und AusnahmendeviceDoorOpen
: Die Tür des Geräts ist geöffnet.deviceLidOpen
: Der Deckel des Geräts ist geöffnet.fractionalAmountNotSupported
: Der Nutzer hat einen Bruchteil für diese Voreinstellung angefordert, die aber von diesem Gerät nicht unterstützt wird.amountAboveLimit
: Der Nutzer hat eine Menge angefordert, die über dem Maximum liegt.unknownFoodPreset
: Der Nutzer hat eine Voreinstellung für Lebensmittel angefordert, die vom Gerät nicht unterstützt wird.