Willkommen im Google Home Developer Center, dem neuen Ort, an dem Sie lernen, wie Sie Smart-Home-Aktionen entwickeln.

Diese Seite wurde von der Cloud Translation API übersetzt.

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.