Esquema de las características de Smart Home Cook

action.devices.traits.Cook: Esta característica pertenece a los dispositivos que pueden cocinar según diferentes ajustes predeterminados y modos de cocción admitidos.

Algunos ejemplos de estos tipos de dispositivos incluyen Multicooker, olla de presión, licuadora y microonda. Los comandos de cocina pueden incluir la cantidad y el nombre de la comida, como "Dos tazas de arroz integral", en el que "arroz integral" es un ajuste predeterminado para el dispositivo.

Esta característica no controla el tiempo de cocción ni la temperatura de cocción. Consulta Temporizador y Control de temperatura 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 manejar los intents SYNC, consulta Entrega de intents.

Atributos	Tipo	Descripción
supportedCookingModes	Matriz	Obligatorio. Modos de cocina compatibles con este dispositivo
[item, ...]	String	Modo de 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	Ajustes predeterminados de comida.
food_preset_name	String	Obligatorio. Nombre interno del ajuste predeterminado, que se usará en comandos y estados. Este nombre puede ser poco 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 de nombres de alimentos para el ajuste predeterminado en cada idioma admitido.
[item, ...]	Objeto	Nombre de la comida.
synonym	Matriz	Obligatorio. Los sinónimos del ajuste predeterminado deben incluir formas en singular y plural, si corresponde.
[item, ...]	String	Nombre de sinónimos preestablecido.
lang	String	Obligatorio. Código de idioma (ISO 639-1). Consulte los idiomas compatibles.

Ejemplos

Dispositivo con solo un modo de cocción y sin ajuste predeterminado.

{
  "supportedCookingModes": [
    "BAKE"
  ]
}

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

Dispositivo STATEs

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

Estados	Tipo	Descripción
currentCookingMode	String	Obligatorio. Describe el modo de cocción actual establecido en el dispositivo de la lista de atributos supportedCookingModes. Solo se puede informar un modo. Si no hay ningún modo seleccionado actualmente, se debe establecer en NINGUNO.
currentFoodPreset	String	Describe la cocina actual en el dispositivo, a partir de la lista de atributos foodPresets. Solo se puede informar una comida. Si no hay comida seleccionada, se debe configurar NINGUNO.
currentFoodQuantity	Número	Define la cantidad actual de comida cocinada asociada con el currentFoodUnit, si se especificó una cantidad. No se debe informar si no se está cocinando nada o si no hay una cantidad asociada con este ajuste predeterminado de comida.
currentFoodUnit	String	La unidad asociada con el currentFoodQuantity, de la lista de atributo supported_units.

Ejemplos

¿Se cocina el horno?

{
  "currentCookingMode": "BAKE"
}

¿Qué se está cocinando en la arrocera?

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

Dispositivo COMMAND

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 manejar los intents EXECUTE, consulta Entrega de intents.

action.devices.commands.Cook

Iniciar o detener la cocina

Parámetros

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

Ejemplos

Empieza a hornear en el horno.

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

Deja de hornear en el horno.

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

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

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

Dispositivo ERRORS

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, pero no es compatible con este dispositivo.
• amountAboveLimit: El usuario solicitó una cantidad que superó el máximo.
• unknownFoodPreset: El usuario solicitó un ajuste predeterminado de comida que no es compatible con el dispositivo.