Willkommen beim Google Home Developer Center, der neuen Anlaufstelle für Smart-Home-Aktionen. Hinweis:Sie erstellen weiterhin Aktionen in der Actions Console.
Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Schema von Smart Home Cook Trait

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

Beispiele für diese Gerätetypen sind Multikocher, Schnellkocher, Mixer und Mikrowelle. Kochbefehle können die Menge und den Namen des Essens enthalten, z. B. „Zwei Tassen brauner Reis“, wobei „brauner Reis“ eine Voreinstellung für das Gerät ist.

Diese Eigenschaft verarbeitet die Garzeit oder Kochtemperatur nicht. Weitere Informationen finden Sie unter Timer und Temperaturregler.

Gerät ATTRIBUTE

Geräte mit diesem Attribut können im Rahmen des Vorgangs SYNC die folgenden Attribute melden. 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 Arten von Speisen

[item, ...] Objekt

Lebensmittelvoreinstellung.

food_preset_name String

Erforderlich.

Interner Name der Lebensmittelvoreinstellung, 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 Einheiten, die vom Gerät für ein bestimmtes Essen 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

Lebensmittelname.

synonym Array

Erforderlich.

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

[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ät STATES

Geräte mit diesem Attribut können im Rahmen des Vorgangs QUERY die folgenden Zustände melden. Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Intent-Auftragsausführung.

Bundesstaaten Typ Beschreibung
currentCookingMode String

Erforderlich.

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

currentFoodPreset String

Beschreibt die aktuelle Zubereitung aus dem Gerät in der Liste der foodPresets-Attribute. Es darf nur ein Lebensmittel gemeldet werden. Wenn aktuell kein Lebensmittel ausgewählt ist, sollte dies auf NONE festgelegt werden.

currentFoodQuantity Number

Definiert die aktuelle Menge des mit dem currentFoodUnit verknüpften Lebensmittelkochens, falls eine Menge angegeben wurde. Sollte nicht gemeldet werden, wenn nichts mit dem Kochen gekocht wird oder wenn dieser Voreinstellung keine Menge zugeordnet ist.

currentFoodUnit String

Die mit dem Attribut „currentFoodQuantity“ verknüpfte Einheit aus der Liste der supported_units-Attribute.

Beispiele

Wird im Ofen gekocht?

{
  "currentCookingMode": "BAKE"
}

Was kocht gerade in meinem Reiskocher?

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

Gerätebefehle

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

action.devices.commands.Cook

Kochen oder beenden Sie das Kochen.

Parameter

Parameter Typ Beschreibung
start Boolesch

Erforderlich.

True, um mit dem Kochen zu beginnen, False, um den aktuellen Kochmodus zu beenden.

cookingMode String

Kochmodus des Geräts wurde über das Attribut supportedCookingModes angefordert.

foodPreset String

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

quantity Number

Die Menge des Essens, die der Nutzer angefordert hat.

unit String

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

Beispiele

Backe in meinen Ofen.

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

Beende das Backen in meinem Ofen.

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

Beginne mit der Zubereitung von 2 Tassen weißen Reis in meinem Reiskocher.

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

Gerät ERRORS

Vollständige Liste der Fehler und Ausnahmen
  • deviceDoorOpen: Die Tür des Geräts ist geöffnet.
  • deviceLidOpen: Der Deckel des Geräts ist geöffnet.
  • fractionalAmountNotSupported: Der Nutzer hat einen Bruchteil für diese Voreinstellung angefordert, die aber von diesem Gerät nicht unterstützt wird.
  • 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.