Diese Seite wurde von der Cloud Translation API übersetzt.

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: `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 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: `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	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 `supportedCookingModes`-Attribute auf dem Gerät festgelegt ist. Es kann nur ein Modus gemeldet werden. Wenn derzeit kein Modus ausgewählt ist, sollte dieser auf NONE festgelegt werden.
`currentFoodPreset`	String	Beschreibt die aktuelle Zubereitung aus dem Gerät in der Liste der `foodPresets`-Attribute. Es darf nur ein Lebensmittel gemeldet werden. Wenn aktuell kein Lebensmittel ausgewählt ist, sollte dies auf NONE festgelegt werden.
`currentFoodQuantity`	Number	Definiert die aktuelle Menge des mit dem `currentFoodUnit` verknüpften Lebensmittelkochens, falls eine Menge angegeben wurde. Sollte nicht gemeldet werden, wenn nichts mit dem Kochen gekocht wird oder wenn dieser Voreinstellung keine Menge zugeordnet ist.
`currentFoodUnit`	String	Die mit dem Attribut „`currentFoodQuantity`“ verknüpfte Einheit aus der Liste der `supported_units`-Attribute.

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 `supportedCookingModes` angefordert.
`foodPreset`	String	Der Name der Voreinstellung, die der Nutzer vom Attribut „`foodPresets`“ angefordert hat.
`quantity`	Number	Die Menge des Essens, die der Nutzer angefordert hat.
`unit`	String	Die mit dem Attribut „`quantity`“ verknüpfte Einheit aus dem Attribut `supported_units`.

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 Ausnahmen

deviceDoorOpen: 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.