Diese Seite wurde von der Cloud Translation API übersetzt.

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: `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	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: `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	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 `supportedCookingModes`-Attributs festgelegt ist. Es kann nur ein Modus gemeldet werden. Wenn derzeit kein Modus ausgewählt ist, sollte dies auf NONE festgelegt werden.
`currentFoodPreset`	String	Beschreibt die aktuelle Kochküche im Gerät aus der Liste des `foodPresets`-Attributs. Es kann nur ein Lebensmittel gemeldet werden. Wenn keine Lebensmittel ausgewählt sind, sollte dies auf NONE festgelegt werden.
`currentFoodQuantity`	Number	Definiert die aktuelle Menge des mit dem `currentFoodUnit` verknüpften Kochens, wenn eine Menge angegeben wurde. Sollte nicht gemeldet werden, wenn derzeit keine Speisen zubereitet werden oder wenn dieser Voreinstellung keine Menge zugeordnet ist.
`currentFoodUnit`	String	Die mit dem `currentFoodQuantity` verknüpfte Einheit aus der Liste des `supported_units`-Attributs.

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

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.