Willkommen beim Google Home Developer Center, der neuen Anlaufstelle für Informationen über Smart-Home-Aktionen. Hinweis:Die Aktionen in der Actions Console werden weiterhin erstellt.

Schema für Smart Home Cook Trait

action.devices.traits.Cook: Diese Eigenschaft gehört zu Geräten, die Lebensmittel anhand verschiedener Voreinstellungen und unterstützter Kochmodi kochen können.

Beispiele für diese Gerätetypen sind Multikocher, Schnellkochtopf, Blender und Mikrowelle. Cook-Befehle können die Menge und den Namen des Essens enthalten, z. B. „Zwei Becher brauner Reis“, wobei „brauner Reis“ eine Voreinstellung für das Gerät ist.

Diese Eigenschaft hat weder die Zubereitungszeit noch die Zubereitungstemperatur im Blick. Weitere Informationen findest du unter Timer und TemperatureControl.

Geräte-ATTRIBUTE

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

Attribute Typ Beschreibung
supportedCookingModes Array

Erforderlich.

Die von diesem Gerät unterstützten 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 Speisen.

[item, ...] Objekt

Voreinstellung für Lebensmittel.

food_preset_name String

Erforderlich.

Interner Name der Lebensmittel-Voreinstellung, der in Befehlen und Status verwendet wird. Dieser Name ist für Nutzer unter Umständen nicht nutzerfreundlich und wird in allen 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

Voreingestellter Synonymname.

lang String

Erforderlich.

Sprachcode (ISO 639-1). Siehe unterstützte Sprachen

Beispiele

Gerät mit nur einem Kochmodus und ohne Voreinstellung.

{
  "supportedCookingModes": [
    "BAKE"
  ]
}

Gerät mit mehreren Kochmodi und Lebensmittelvoreinstellungen

{
  "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 Merkmal können im Rahmen des QUERY-Vorgangs die folgenden Status melden: Weitere Informationen zum Verarbeiten von QUERY-Intents finden Sie unter Intent-Auftragsausführung.

Bundesstaaten Typ Beschreibung
currentCookingMode String

Erforderlich.

Beschreibt den aktuellen Kochmodus, der auf dem Gerät aus der Liste des supportedCookingModes-Attributs festgelegt ist. Es kann nur ein Modus gemeldet werden. Wenn derzeit kein Modus ausgewählt ist, sollte dies auf NONE festgelegt werden.

currentFoodPreset String

Beschreibt die aktuelle Kochküche im Gerät aus der Liste des foodPresets-Attributs. Es kann nur ein Lebensmittel gemeldet werden. Wenn keine Lebensmittel ausgewählt sind, sollte dies auf NONE festgelegt werden.

currentFoodQuantity Number

Definiert die aktuelle Menge des mit dem currentFoodUnit verknüpften Kochens, wenn eine Menge angegeben wurde. Sollte nicht gemeldet werden, wenn derzeit keine Speisen zubereitet werden oder wenn dieser Voreinstellung keine Menge zugeordnet ist.

currentFoodUnit String

Die mit dem currentFoodQuantity verknüpfte Einheit aus der Liste des supported_units-Attributs.

Beispiele

Ist mein Ofen gekocht?

{
  "currentCookingMode": "BAKE"
}

Was wird gerade in meinem Reiskocher gekocht?

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

BEISPIELE für Geräte

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

action.devices.commands.Cook

Kochen oder anhalten.

Parameter

Parameter Typ Beschreibung
start Boolesch

Erforderlich.

True, um das Kochen zu starten, false, um den aktuellen Kochmodus zu stoppen.

cookingMode String

Der Kochmodus für das Gerät wurde aus dem Attribut supportedCookingModes angefordert.

foodPreset String

Der Name der Voreinstellung, die der Nutzer vom Attribut „foodPresets“ angefordert hat.

quantity Number

Die Menge des vom Nutzer angeforderten Essens.

unit String

Die mit dem Attribut „quantity“ verknüpfte Einheit aus dem Attribut „supported_units“.

Beispiele

Backen im Ofen.

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

In meinem Ofen aufhören zu backen.

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

Starte in meinem Reiskocher 2 Tassen weißen Reis.

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

Gerät ERRORS

Hier finden Sie die 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 einen Bruchteil der Voreinstellung für Essen angefordert, wird von diesem Gerät aber nicht unterstützt.
  • amountAboveLimit: Der Nutzer hat eine Menge angefordert, die über dem Höchstwert liegt.
  • unknownFoodPreset: Der Nutzer hat eine Voreinstellung angefordert, die vom Gerät nicht unterstützt wird.