Schema für Smart-Home-Kochköche

action.devices.traits.Cook: Diese Eigenschaft gehört zu Geräten, mit denen Lebensmittel je nach Voreinstellungen und unterstützten Kochmodi zubereitet werden können.

Beispiele für diese Gerätetypen sind Multicooker, Pressure cooker, Blender und Microwave. Kochbefehle können die Anzahl und den Namen das Essen, zum Beispiel „Zwei Tassen brauner Reis“, wobei „brauner Reis“ ist eine Lebensmittel-Voreinstellung für das Gerät.

Diese Eigenschaft berücksichtigt nicht die Kochzeit oder Kochtemperatur. Weitere Informationen: Timer und TemperatureControl .

Geräte-ATTRIBUTES

Auf Geräten mit diesem Trait kann Folgendes gemeldet werden im Rahmen des SYNC-Vorgangs verwenden. Weitere Informationen Weitere Informationen zum Umgang mit SYNC-Intents finden Sie unter Absichtliche Umsetzung.

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.
food_preset_name	String	Erforderlich. Interner Name der Lebensmittel-Voreinstellung, 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 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 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 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ät: STATES

Entitäten mit diesem Merkmal melden möglicherweise Folgendes: QUERY-Bundesstaaten. Weitere Informationen Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Absichtliche Umsetzung.

Bundesstaaten	Typ	Beschreibung
currentCookingMode	String	Erforderlich. Beschreibt den aktuell auf dem Gerät festgelegten Kochmodus anhand des Attributs supportedCookingModes. Es kann nur ein Modus gemeldet werden. Ist derzeit kein Modus ausgewählt, sollte dieser Modus auf KEINEN festgelegt werden.
currentFoodPreset	String	Die food_preset_name des gerade auf dem Gerät kochenden Essens aus dem Attribut foodPresets. Es kann nur ein Lebensmittel gemeldet werden. Wenn derzeit kein Lebensmittel ausgewählt ist, sollte dieser Wert auf KEINEN Wert gesetzt werden.
currentFoodQuantity	Number	Definiert die aktuelle Menge der gekochten Speisen, die mit currentFoodUnit verknüpft sind, 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 mit currentFoodQuantity verknüpfte Einheit aus der Liste der supported_units in der Voreinstellung.

Beispiele

Kann mein Ofen kochen?

{
  "currentCookingMode": "BAKE"
}

Was kocht gerade mein Reiskocher?

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

Gerät "COMMANDS"

Geräte mit diesem Merkmal können auf Folgendes reagieren im Rahmen des EXECUTE-Vorgangs ausgeführt. Weitere Informationen Weitere Informationen zum Umgang mit EXECUTE-Intents finden Sie unter Absichtliche Umsetzung.

action.devices.commands.Cook

Kochen beginnen oder beenden.

Parameter

Parameter	Typ	Beschreibung
start	Boolesch	Erforderlich. "True", um den Kochmodus zu starten, "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 vom Nutzer angeforderten Lebensmittel-Voreinstellung aus dem Attribut foodPresets.
quantity	Number	Die vom Nutzer angeforderte Menge der Lebensmittel.
unit	String	Die mit dem quantity verknüpfte Einheit aus supported_units-Attribut.

Beispiele

Fang im Backofen an.

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

Hör auf, im Ofen zu backen.

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

Beginne damit, zwei Tassen weißen Reis im Reiskocher zu kochen.

{
  "command": "action.devices.commands.Cook",
  "params": {
    "start": true,
    "cookingMode": "COOK",
    "foodPreset": "white_rice",
    "quantity": 2,
    "unit": "CUPS"
  }
}

Gerätefehler

Vollständige Liste der Fehler und Ausnahmen.

• deviceDoorOpen: Die Gerätetür ist offen.
• deviceLidOpen: Der Deckel des Geräts ist geöffnet.
• fractionalAmountNotSupported: Der Nutzer hat dafür einen Bruchteil angefordert. Voreinstellung für Lebensmittel, aber diese Funktion wird von diesem Gerät nicht unterstützt.
• 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.