Esquema de atributos de Smart Home Cook

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 cocción pueden incluir la cantidad y el nombre del alimento, como "Dos tazas de arroz integral", en el que "arroz integral" es un alimento predeterminado para el dispositivo.

Este atributo 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 esta característica pueden informar los siguientes atributos como parte de la operación SYNC. Para obtener más información sobre cómo controlar intents SYNC, consulta Cómo entregar 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 alimentos
[item, ...]	Objeto	Configuración predeterminada de comida.
food_preset_name	String	Obligatorio. Es el nombre interno del preajuste 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 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. Los sinónimos del parámetro preestablecido deben incluir las formas singular y plural, si corresponde.
[item, ...]	String	Es el nombre del sinónimo predeterminado.
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 comida.

{
  "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 atributo pueden informar los siguientes estados como parte de la operación QUERY. Para obtener más información sobre cómo controlar intents QUERY, consulta Cómo entregar intents.

Estados	Tipo	Descripción
currentCookingMode	String	Obligatorio. Describe el modo de cocción actual establecido en el dispositivo, desde el 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, del atributo foodPresets. Solo se puede informar un alimento. Si no se seleccionó ningún alimento, este valor debe establecerse 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 ninguna cantidad asociada con este ajuste predeterminado.
currentFoodUnit	String	Es la unidad asociada con el currentFoodQuantity, de la lista de supported_units del parámetro 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 esta característica pueden responder a los siguientes comandos como parte de la operación EXECUTE. Para obtener más información sobre cómo controlar intents EXECUTE, consulta Cómo entregar intents.

action.devices.commands.Cook

Iniciar o detener la cocción

Parámetros

Parámetros	Tipo	Descripción
start	Booleano	Obligatorio. Es verdadero para iniciar la cocción y falso para detener el modo de cocción actual.
cookingMode	String	Es el modo de cocción solicitado para el dispositivo, del atributo supportedCookingModes.
foodPreset	String	Es el nombre del alimento predeterminado que solicitó el usuario, del atributo foodPresets.
quantity	Número	Es la cantidad de comida que solicitó el usuario.
unit	String	Es la unidad asociada con quantity, del atributo supported_units.

Ejemplos

Comenzar a hornear en mi horno

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

Deja de hornear en mi horno.

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

Comencé 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ó un importe fraccionario para este preajuste de comida, pero este dispositivo no lo admite.
• amountAboveLimit: El usuario solicitó una cantidad superior a la máxima.
• unknownFoodPreset: El usuario solicitó un alimento predeterminado que el dispositivo no admite.