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: UNKNOWN_COOKING_MODE BAKE BEAT BLEND BOIL BREW BROIL CONVECTION_BAKE COOK DEFROST DEHYDRATE FERMENT FRY GRILL KNEAD MICROWAVE MIX PRESSURE_COOK PUREE ROAST SAUTE SLOW_COOK SOUS_VIDE STEAM STEW STIR WARM WHIP
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: UNKNOWN_UNITS NO_UNITS CENTIMETERS CUPS DECILITERS FEET FLUID_OUNCES GALLONS GRAMS INCHES KILOGRAMS LITERS METERS MILLIGRAMS MILLILITERS MILLIMETERS OUNCES PINCH PINTS PORTION POUNDS QUARTS TABLESPOONS TEASPOONS
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 supportedCookingModes-Attributs. Es kann nur ein Modus gemeldet werden. Wenn aktuell kein Modus ausgewählt ist, sollte dieser auf NONE gesetzt sein.
currentFoodPreset	String	Beschreibt das Kochen von Speisen auf dem Gerät anhand der Liste des Attributs foodPresets. Es darf nur ein Lebensmittel gemeldet werden. Wenn aktuell kein Essen ausgewählt ist, sollte „NONE“ festgelegt sein.
currentFoodQuantity	Number	Definiert die aktuelle Zubereitungsmenge von Lebensmitteln, die mit currentFoodUnit verknüpft ist, wenn eine Menge angegeben wurde. Sollte nicht gemeldet werden, wenn gerade nichts kocht oder wenn mit dieser Voreinstellung keine Menge verknüpft ist.
currentFoodUnit	String	Die Einheit, die mit currentFoodQuantity verknüpft ist, aus der Liste des supported_units-Attributs.

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 supportedCookingModes angefordert.
foodPreset	String	Der Name der Lebensmittelvoreinstellung, die vom Nutzer aus dem Attribut foodPresets angefordert wurde.
quantity	Number	Die vom Nutzer angeforderte Menge der Lebensmittel.
unit	String	Die Einheit, die mit dem Attribut „quantity“ aus dem supported_units-Attribut verknüpft ist.

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.