Smart Home Cook-Trait-Schema
action.devices.traits.Cook
: Dieses Merkmal gehört zu Geräten, die Speisen gemäß verschiedenen Voreinstellungen und unterstützten Kochmodi zubereiten können.
Beispiele für diese Gerätetypen sind Multicooker, Pressure cooker, Blender und Microwave. Kochbefehle können die Menge und den Namen des Lebensmittels enthalten, z. B. „Zwei Tassen brauner Reis“, wobei „brauner Reis“ eine Voreinstellung für das Gerät ist.
Mit diesem Attribut werden keine Kochzeit oder Kochtemperatur angegeben. Weitere Informationen finden Sie unter Timer und TemperatureControl.
Geräteattribute
Geräte mit diesem Merkmal können die folgenden Attribute als Teil des Vorgangs SYNC
melden. Weitere Informationen zum Umgang mit SYNC
-Intents finden Sie unter Intent-Fulfillment.
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 Lebensmitteln. |
[item, ...] |
Objekt |
Voreinstellung für 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 vom Gerät unterstützten Einheiten für ein bestimmtes Lebensmittel. |
[item, ...] |
String |
Unterstützte Einheit. Unterstützte Werte:
|
food_synonyms |
Array |
Erforderlich. Synonyme für den Namen des Lebensmittels für die Voreinstellung in jeder unterstützten Sprache. |
[item, ...] |
Objekt |
Name des Lebensmittels. Mindestens ein Artikel mit dem |
synonym |
Array |
Erforderlich. Synonyme für die Voreinstellung, die gegebenenfalls sowohl Singular- als auch Pluralformen enthalten sollten. |
[item, ...] |
String |
Synonymname der Voreinstellung. Mindestens ein Artikel mit dem |
lang |
String |
Erforderlich. Sprachcode (ISO 639-1). Unterstützte Sprachen |
Beispiele
Gerät mit nur einem Kochmodus und ohne Voreinstellung:
{ "supportedCookingModes": [ "BAKE" ] }
Gerät mit mehreren Kochmodi und Voreinstellungen für Lebensmittel
{ "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
Für Entitäten mit diesem Merkmal können im Rahmen des Vorgangs QUERY
die folgenden Status gemeldet werden. Weitere Informationen zum Umgang mit QUERY
-Intents finden Sie unter Intent-Fulfillment.
Bundesstaaten | Typ | Beschreibung |
---|---|---|
currentCookingMode |
String |
Erforderlich. Beschreibt den aktuellen Kochmodus, der auf dem Gerät eingestellt ist, aus dem Attribut |
currentFoodPreset |
String |
Die |
currentFoodQuantity |
Number |
Definiert die aktuelle Menge an zubereiteten Lebensmitteln, die mit |
currentFoodUnit |
String |
Die Einheit, die mit dem |
Beispiele
Ist mein Backofen in Betrieb?
{ "currentCookingMode": "BAKE" }
Was kocht gerade in meinem Reiskocher?
{ "currentCookingMode": "COOK", "currentFoodPreset": "brown_rice", "currentFoodQuantity": 2, "currentFoodUnit": "CUPS" }
GERÄTEBEFEHLE
Geräte mit diesem Merkmal können im Rahmen des Vorgangs EXECUTE
auf die folgenden Befehle reagieren. Weitere Informationen zum Umgang mit EXECUTE
-Intents finden Sie unter Intent-Fulfillment.
action.devices.commands.Cook
Kochen starten oder beenden
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
start |
Boolesch |
Erforderlich. „True“, um mit dem Kochen zu beginnen, „false“, um den aktuellen Kochmodus zu beenden. |
cookingMode |
String |
Angeforderter Kochmodus für das Gerät aus dem Attribut |
foodPreset |
String |
Der Name des vom Nutzer angeforderten Lebensmittel-Presets aus dem Attribut |
quantity |
Number |
Die vom Nutzer angeforderte Menge an Lebensmitteln. |
unit |
String |
Die Einheit, die mit |
Beispiele
Starte den Backvorgang in meinem Ofen.
{ "command": "action.devices.commands.Cook", "params": { "start": true, "cookingMode": "BAKE" } }
Höre auf, in meinem Ofen zu backen.
{ "command": "action.devices.commands.Cook", "params": { "start": false, "cookingMode": "BAKE" } }
Starte den Reiskocher und koche 2 Tassen weißen Reis.
{ "command": "action.devices.commands.Cook", "params": { "start": true, "cookingMode": "COOK", "foodPreset": "white_rice", "quantity": 2, "unit": "CUPS" } }
GERÄTEFEHLER
Vollständige Liste der Fehler und AusnahmendeviceDoorOpen
– Die Tür des Geräts ist offen.deviceLidOpen
– Der Deckel des Geräts ist offen.fractionalAmountNotSupported
: Der Nutzer hat für diese Voreinstellung für Lebensmittel einen Bruchteil angefordert, der von diesem Gerät nicht unterstützt wird.amountAboveLimit
– Der Nutzer hat eine Menge angefordert, die über dem Maximum lag.unknownFoodPreset
: Der Nutzer hat eine Voreinstellung für Lebensmittel angefordert, die vom Gerät nicht unterstützt wird.