Esquema de rasgos de cocina de casa inteligente

action.devices.traits.Cook: Este rasgo pertenece a dispositivos que pueden cocinar alimentos de acuerdo con varios ajustes predeterminados y modos de cocción compatibles.

Algunos ejemplos de estos tipos de dispositivo son Multicooker, Pressure cooker, Blender y Microwave. Los comandos de Cook pueden incluir la cantidad y el nombre de la comida, como "Dos tazas de arroz integral", donde "Arroz integral" es un ajuste predeterminado de alimentos para el dispositivo.

Esta característica no controla el tiempo ni la temperatura de cocción. Ver Timer y TemperatureControl para obtener más información.

ATRIBUTOS DISPOSITIVOS

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

Atributos	Tipo	Descripción
supportedCookingModes	Matriz	Obligatorio. Modos de cocción compatibles con este dispositivo.
[item, ...]	String	Modo cocina. 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 comida.
[item, ...]	Objeto	Ajuste predeterminado de comida.
food_preset_name	String	Obligatorio. Nombre interno del ajuste predeterminado de alimentos, que se usará en comandos y estados. Este nombre no puede ser fácil de usar y se comparte en todos los idiomas.
supported_units	Matriz	Obligatorio. Contiene todas las unidades que admite el dispositivo para un alimento específico.
[item, ...]	String	Unidad compatible. 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. Sinónimos del nombre del alimento para el ajuste predeterminado en cada idioma compatible.
[item, ...]	Objeto	Nombre del alimento.
synonym	Matriz	Obligatorio. Sinónimos del ajuste predeterminado, deben incluir formas singulares y plurales, si corresponde.
[item, ...]	String	Nombre de sinónimo predeterminado.
lang	String	Obligatorio. Código de idioma (ISO 639-1). Consulta los idiomas compatibles.

Ejemplos

Dispositivo con solo un modo de cocina y sin ajuste predeterminado.

{
  "supportedCookingModes": [
    "BAKE"
  ]
}

Dispositivo con múltiples 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"
        }
      ]
    }
  ]
}

Dispositivo STATES

Las entidades con esta característica pueden informar lo siguiente estados como parte de la operación QUERY. Para aprender Para obtener más información sobre cómo controlar los intents QUERY, consulta Entrega de intents.

Estados	Tipo	Descripción
currentCookingMode	String	Obligatorio. Describe el modo de cocina configurado en el dispositivo, a partir del atributo supportedCookingModes. Solo se puede informar un modo. Si no hay ningún modo seleccionado, se debe establecer en NINGUNO.
currentFoodPreset	String	El food_preset_name de la comida que se está cocinando en el dispositivo, desde el atributo foodPresets. Solo se puede informar un alimento. Si no hay ningún alimento seleccionado, la opción debe ser NINGUNO.
currentFoodQuantity	Número	Define la cantidad actual de comida cocida asociada con el currentFoodUnit, si se especificó una cantidad. No se debe informar si no se está cocinando nada o si no hay ninguna cantidad asociada con este ajuste predeterminado.
currentFoodUnit	String	La unidad asociada con currentFoodQuantity, de la lista de supported_units del ajuste predeterminado.

Ejemplos

¿Se está cocinando el horno?

{
  "currentCookingMode": "BAKE"
}

¿Qué se está cocinando en mi arrocera ahora?

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

COMANDOS del dispositivo

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

action.devices.commands.Cook

Comienza a cocinar o deja de hacerlo.

Parámetros

Parámetros	Tipo	Descripción
start	Booleano	Obligatorio. Verdadero para comenzar a cocinar; falso para detener el modo de cocina actual.
cookingMode	String	Se solicitó el modo de cocina para el dispositivo, desde el atributo supportedCookingModes.
foodPreset	String	Es el nombre del ajuste predeterminado de comida solicitado por el usuario, del atributo foodPresets.
quantity	Número	La cantidad de comida solicitada por el usuario.
unit	String	La unidad asociada con el quantity, del atributo supported_units.

Ejemplos

Comenzar a cocinar en el horno

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

Dejar de hornear en el horno

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

Comience a cocinar 2 tazas de arroz blanco en la arrocera.

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

ERRORES DE 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 fraccionada por esto. predeterminado de alimentos, pero este dispositivo no lo admite.
• amountAboveLimit: El usuario solicitó una cantidad superior al máximo.
• unknownFoodPreset: El usuario solicitó un ajuste predeterminado de alimentos que el dispositivo no admite.