Smart Home Cook-Trait-Schema

action.devices.traits.Cook: Dieses Merkmal gehört zu Geräten, die Speisen gemäß verschiedenen Voreinstellungen 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 Voreinstellung für das Gerät ist.

Mit diesem Attribut werden keine Kochzeit oder Kochtemperatur angegeben. Weitere Informationen finden Sie unter Timer und TemperatureControl.

Geräteattribute

Geräte mit diesem Merkmal können die folgenden Attribute als Teil des Vorgangs SYNC melden. Weitere Informationen zum Umgang mit SYNC-Intents finden Sie unter Intent-Fulfillment.

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 Lebensmitteln.

[item, ...] Objekt

Voreinstellung für 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 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 den Namen des Lebensmittels für die Voreinstellung in jeder unterstützten Sprache.

[item, ...] Objekt

Name des Lebensmittels. Mindestens ein Artikel mit dem lang-Wert en ist erforderlich, um einen Sprach-Fallback zu ermöglichen.

synonym Array

Erforderlich.

Synonyme für die Voreinstellung, die gegebenenfalls sowohl Singular- als auch Pluralformen enthalten sollten.

[item, ...] String

Synonymname der Voreinstellung. Mindestens ein Artikel mit dem lang-Wert en ist erforderlich, um einen Sprach-Fallback zu ermöglichen.

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

Für Entitäten mit diesem Merkmal können im Rahmen des Vorgangs QUERY die folgenden Status gemeldet werden. Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Intent-Fulfillment.

Bundesstaaten Typ Beschreibung
currentCookingMode String

Erforderlich.

Beschreibt den aktuellen Kochmodus, der auf dem Gerät eingestellt ist, aus dem Attribut supportedCookingModes. Es darf nur ein Modus gemeldet werden. Wenn derzeit kein Modus ausgewählt ist, sollte dieser Wert auf NONE festgelegt werden.

currentFoodPreset String

Die food_preset_name des aktuellen Lebensmittels, das im Gerät zubereitet wird, aus dem Attribut foodPresets. Es kann nur ein Lebensmittel gemeldet werden. Wenn derzeit keine Lebensmittel ausgewählt sind, sollte dieser Wert auf NONE gesetzt werden.

currentFoodQuantity Number

Definiert die aktuelle Menge an zubereiteten Lebensmitteln, die mit currentFoodUnit verknüpft ist, sofern eine Menge angegeben wurde. Sollte nicht gemeldet werden, wenn gerade nichts gekocht wird oder wenn diesem Lebensmittel-Preset keine Menge zugeordnet ist.

currentFoodUnit String

Die Einheit, die mit dem currentFoodQuantity aus der Liste der supported_units des Presets verknüpft ist.

Beispiele

Ist mein Backofen in Betrieb?

{
  "currentCookingMode": "BAKE"
}

Was kocht gerade in meinem Reiskocher?

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

GERÄTEBEFEHLE

Geräte mit diesem Merkmal können im Rahmen des Vorgangs EXECUTE auf die folgenden Befehle reagieren. Weitere Informationen zum Umgang mit EXECUTE-Intents finden Sie unter Intent-Fulfillment.

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 Attribut supportedCookingModes.

foodPreset String

Der Name des vom Nutzer angeforderten Lebensmittel-Presets aus dem Attribut foodPresets.

quantity Number

Die vom Nutzer angeforderte Menge an Lebensmitteln.

unit String

Die Einheit, die mit quantity verknüpft ist, aus dem Attribut supported_units.

Beispiele

Starte den Backvorgang in meinem Ofen.

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

Höre auf, in meinem Ofen zu backen.

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

Starte den Reiskocher und koche 2 Tassen weißen Reis.

{
  "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 Tür des Geräts ist offen.
  • deviceLidOpen – Der Deckel des Geräts ist offen.
  • fractionalAmountNotSupported: Der Nutzer hat für diese Voreinstellung für Lebensmittel einen Bruchteil angefordert, der von diesem Gerät nicht unterstützt wird.
  • amountAboveLimit – Der Nutzer hat eine Menge angefordert, die über dem Maximum lag.
  • unknownFoodPreset: Der Nutzer hat eine Voreinstellung für Lebensmittel angefordert, die vom Gerät nicht unterstützt wird.