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.