Esquema del rasgo de cocción de casa inteligente

action.devices.traits.Cook: Este rasgo pertenece a los dispositivos que pueden cocinar alimentos según varios ajustes predeterminados y modos de cocción admitidos.

Entre los ejemplos de estos tipos de dispositivos, se incluyen Multicooker, Pressure cooker, Blender y Microwave. Los comandos de cocina pueden incluir la cantidad y el nombre de la comida, como "Dos tazas de arroz integral", donde "arroz integral" es un ajuste predeterminado de comida para el dispositivo.

Este rasgo no controla el tiempo ni la temperatura de cocción. Consulta Timer y TemperatureControl para obtener más información.

Atributos del dispositivo

Los dispositivos con este rasgo pueden informar los siguientes atributos como parte de la operación SYNC. Para obtener más información sobre cómo controlar intents de SYNC, consulta Entrega de intents.

Atributos Tipo Descripción
supportedCookingModes Matriz

Obligatorio.

Son los modos de cocción que admite este dispositivo.

[item, ...] String

Modo de cocción

Valores admitidos:

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 Matriz

Ajustes predeterminados para ciertos tipos de alimentos

[item, ...] Objeto

Es un ajuste predeterminado de comida.

food_preset_name String

Obligatorio.

Nombre interno del ajuste predeterminado de comida, que se usará en los comandos y estados. Este nombre puede no ser fácil de usar y se comparte en todos los idiomas.

supported_units Matriz

Obligatorio.

Contiene todas las unidades admitidas por el dispositivo para un alimento específico.

[item, ...] String

Unidad admitida.

Valores admitidos:

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 Matriz

Obligatorio.

Son los sinónimos del nombre de la comida para el ajuste predeterminado en cada idioma admitido.

[item, ...] Objeto

Nombre del alimento. Se requiere al menos un elemento con un valor de lang de en para proporcionar un resguardo de idioma.

synonym Matriz

Obligatorio.

Sinónimos del ajuste predeterminado, que deben incluir las formas en singular y plural, si corresponde.

[item, ...] String

Es el nombre del sinónimo predeterminado. Se requiere al menos un elemento con un valor de lang de en para proporcionar un resguardo de idioma.

lang String

Obligatorio.

Código de idioma (ISO 639-1). Consulta los idiomas admitidos.

Ejemplos

Dispositivo con un solo modo de cocción y sin ajustes predeterminados.

{
  "supportedCookingModes": [
    "BAKE"
  ]
}

Dispositivo con varios modos de cocción y ajustes predeterminados de alimentos.

{
  "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"
        }
      ]
    }
  ]
}

ESTADOS del dispositivo

Las entidades con este rasgo pueden informar los siguientes estados como parte de la operación QUERY. Para obtener más información sobre cómo controlar intents de QUERY, consulta Entrega de intents.

Estados Tipo Descripción
currentCookingMode String

Obligatorio.

Describe el modo de cocción actual establecido en el dispositivo, a partir del atributo supportedCookingModes. Solo se puede informar un modo. Si no hay ningún modo seleccionado actualmente, se debe establecer en NONE.

currentFoodPreset String

Es el food_preset_name de la comida que se está cocinando en el dispositivo, según el atributo foodPresets. Solo se puede informar un alimento. Si no hay comida seleccionada, se debe establecer en NONE.

currentFoodQuantity Número

Define la cantidad actual de comida que se está cocinando asociada con currentFoodUnit, si se especificó una cantidad. No se debe informar si no se está cocinando nada o si no hay una cantidad asociada a este ajuste predeterminado de comida.

currentFoodUnit String

Es la unidad asociada con el currentFoodQuantity, de la lista de supported_units del ajuste predeterminado.

Ejemplos

¿Mi horno está cocinando?

{
  "currentCookingMode": "BAKE"
}

¿Qué se está cocinando en mi olla arrocera en este momento?

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

COMANDOS del dispositivo

Los dispositivos con este rasgo pueden responder a los siguientes comandos como parte de la operación EXECUTE. Para obtener más información sobre cómo controlar intents de EXECUTE, consulta Entrega de intents.

action.devices.commands.Cook

Iniciar o detener la cocción

Parámetros

Parámetros Tipo Descripción
start Booleano

Obligatorio.

Es verdadero para comenzar a cocinar y falso para detener el modo de cocción actual.

cookingMode String

Modo de cocción solicitado para el dispositivo, del atributo supportedCookingModes.

foodPreset String

Es el nombre del ajuste predeterminado de comida que solicitó el usuario, del atributo foodPresets.

quantity Número

Cantidad de comida que solicitó el usuario.

unit String

Es la unidad asociada con el quantity, del atributo supported_units.

Ejemplos

Comienza a hornear en mi horno.

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

Dejar de hornear en mi horno

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

Comienza a cocinar 2 tazas de arroz blanco en mi olla arrocera.

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

ERRORES del dispositivo

Consulta la lista completa de errores y excepciones.
  • deviceDoorOpen: La puerta del dispositivo está abierta.
  • deviceLidOpen: La tapa del dispositivo está abierta.
  • fractionalAmountNotSupported: El usuario solicitó una cantidad fraccionaria para este ajuste predeterminado de comida, pero el dispositivo no la admite.
  • amountAboveLimit: El usuario solicitó una cantidad superior al máximo.
  • unknownFoodPreset: El usuario solicitó un ajuste predeterminado de comida que no admite el dispositivo.