Smart Home Cook Trait Schema

action.devices.traits.Cook – Diese Eigenschaft bezieht sich auf Geräte, die Lebensmittel gemäß verschiedenen Lebensmittelvoreinstellungen 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 Lebensmittelvoreinstellung für das Gerät ist.

Diese Eigenschaft berücksichtigt weder die Garzeit noch die Gartemperatur. Weitere Informationen finden Sie unter Timer und TemperatureControl.

Geräteattribute

Geräte mit diesem Merkmal können die folgenden Attribute im Rahmen des Vorgangs SYNC melden. Weitere Informationen zum Umgang mit SYNC-Intents finden Sie unter Intent-Ausführung.

Attribute	Typ	Beschreibung
supportedCookingModes	Array	Erforderlich. Kochmodi, die von diesem Gerät unterstützt werden
[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	Voreingestellte Lebensmittel
food_preset_name	String	Erforderlich. Interner Name der Lebensmittelvoreinstellung, der in Befehlen und Status verwendet wird. Dieser Name kann nicht nutzerfreundlich sein 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: 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 Synonyme-Presets.
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

Entitäten mit diesem Attribut können im Rahmen des Vorgangs QUERY die folgenden Status melden. Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Intent-Ausführung.

Bundesstaaten	Typ	Beschreibung
currentCookingMode	String	Erforderlich. Beschreibt den aktuellen Kochmodus, der auf dem Gerät festgelegt ist, anhand des Attributs supportedCookingModes. Es kann nur ein Modus gemeldet werden. Wenn derzeit kein Modus ausgewählt ist, sollte dieser Wert auf „NONE“ (KEIN) gesetzt werden.
currentFoodPreset	String	Der food_preset_name des aktuell im Gerät zubereiteten Essens aus dem Attribut foodPresets. Es kann nur ein Lebensmittel gemeldet werden. Wenn derzeit kein Lebensmittel ausgewählt ist, sollte hier „NONE“ (KEIN) festgelegt werden.
currentFoodQuantity	Number	Definiert die aktuelle Menge der zubereiteten Speisen, die mit currentFoodUnit verknüpft ist, sofern eine Menge angegeben wurde. Sollte nicht gemeldet werden, wenn derzeit nichts gekocht wird oder wenn mit dieser Lebensmittelvoreinstellung keine Menge verknüpft ist.
currentFoodUnit	String	Die mit dem currentFoodQuantity verknüpfte Einheit aus der Liste der supported_units des Presets.

Beispiele

Ist mein Backofen in Betrieb?

{
  "currentCookingMode": "BAKE"
}

Was wird gerade in meinem Reiskocher gekocht?

{
  "currentCookingMode": "COOK",
  "currentFoodPreset": "brown_rice",
  "currentFoodQuantity": 2,
  "currentFoodUnit": "CUPS"
}

BEFEHLE für Geräte

Geräte mit dieser Eigenschaft können im Rahmen des Vorgangs EXECUTE auf die folgenden Befehle reagieren. Weitere Informationen zum Umgang mit EXECUTE-Intents finden Sie unter Intent-Ausführung.

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 supportedCookingModes-Attribut.
foodPreset	String	Der Name der vom Nutzer angeforderten Lebensmittelvorlage aus dem Attribut foodPresets.
quantity	Number	Die vom Nutzer angeforderte Menge der Speise.
unit	String	Die mit dem quantity verknüpfte Einheit aus supported_units-Attribut.

Beispiele

Beginne mit dem Backen in meinem Ofen.

{
  "command": "action.devices.commands.Cook",
  "params": {
    "start": true,
    "cookingMode": "BAKE"
  }
}

Hören Sie auf, in meinem Ofen zu backen.

{
  "command": "action.devices.commands.Cook",
  "params": {
    "start": false,
    "cookingMode": "BAKE"
  }
}

Koche 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ÄTEFEHLER

Eine 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 für diese Lebensmittelvoreinstellung einen Bruchteil angefordert, der von diesem Gerät nicht unterstützt wird.
• amountAboveLimit: Der Nutzer hat eine Menge angefordert, die über der maximalen Menge liegt.
• unknownFoodPreset – Der Nutzer hat eine Lebensmittelvoreinstellung angefordert, die vom Gerät nicht unterstützt wird.