Schema für Smart Home Cook Trait
action.devices.traits.Cook
: Diese Eigenschaft gehört zu Geräten, die Lebensmittel anhand verschiedener Voreinstellungen und unterstützter Kochmodi kochen können.
Beispiele für diese Gerätetypen sind Multikocher, Schnellkochtopf, Blender und Mikrowelle. Cook-Befehle können die Menge und den Namen des Essens enthalten, z. B. „Zwei Becher brauner Reis“, wobei „brauner Reis“ eine Voreinstellung für das Gerät ist.
Diese Eigenschaft hat weder die Zubereitungszeit noch die Zubereitungstemperatur im Blick. Weitere Informationen findest du unter Timer und TemperatureControl.
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 |
---|---|---|
supportedCookingModes |
Array |
Erforderlich. Die von diesem Gerät unterstützten Kochmodi |
[item, ...] |
String |
Kochmodus Unterstützte Werte:
|
foodPresets |
Array |
Voreinstellungen für bestimmte Arten von Speisen. |
[item, ...] |
Objekt |
Voreinstellung für Lebensmittel. |
food_preset_name |
String |
Erforderlich. Interner Name der Lebensmittel-Voreinstellung, der in Befehlen und Status verwendet wird. Dieser Name ist für Nutzer unter Umständen nicht nutzerfreundlich und wird in allen 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 |
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ä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 |
---|---|---|
currentCookingMode |
String |
Erforderlich. Beschreibt den aktuellen Kochmodus, der auf dem Gerät aus der Liste des |
currentFoodPreset |
String |
Beschreibt die aktuelle Kochküche im Gerät aus der Liste des |
currentFoodQuantity |
Number |
Definiert die aktuelle Menge des mit dem |
currentFoodUnit |
String |
Die mit dem |
Beispiele
Ist mein Ofen gekocht?
{ "currentCookingMode": "BAKE" }
Was wird gerade in meinem Reiskocher gekocht?
{ "currentCookingMode": "COOK", "currentFoodPreset": "brown_rice", "currentFoodQuantity": 2, "currentFoodUnit": "CUPS" }
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.Cook
Kochen oder anhalten.
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
start |
Boolesch |
Erforderlich. True, um das Kochen zu starten, false, um den aktuellen Kochmodus zu stoppen. |
cookingMode |
String |
Der Kochmodus für das Gerät wurde aus dem Attribut |
foodPreset |
String |
Der Name der Voreinstellung, die der Nutzer vom Attribut „ |
quantity |
Number |
Die Menge des vom Nutzer angeforderten Essens. |
unit |
String |
Die mit dem Attribut „ |
Beispiele
Backen im Ofen.
{ "command": "action.devices.commands.Cook", "params": { "start": true, "cookingMode": "BAKE" } }
In meinem Ofen aufhören zu backen.
{ "command": "action.devices.commands.Cook", "params": { "start": false, "cookingMode": "BAKE" } }
Starte in meinem Reiskocher 2 Tassen weißen Reis.
{ "command": "action.devices.commands.Cook", "params": { "start": true, "cookingMode": "COOK", "foodPreset": "white_rice", "quantity": 2, "unit": "CUPS" } }
Gerät ERRORS
Hier finden Sie die vollständige Liste der Fehler und Ausnahmen.deviceDoorOpen
– Die Tür des Geräts ist offen.deviceLidOpen
– Der Deckel des Geräts ist offen.fractionalAmountNotSupported
: Der Nutzer hat einen Bruchteil der Voreinstellung für Essen angefordert, wird von diesem Gerät aber nicht unterstützt.amountAboveLimit
: Der Nutzer hat eine Menge angefordert, die über dem Höchstwert liegt.unknownFoodPreset
: Der Nutzer hat eine Voreinstellung angefordert, die vom Gerät nicht unterstützt wird.