Se usó la API de Cloud Translation para traducir esta página.

Esquema de la función de cocción de casa inteligente

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

Algunos ejemplos de estos tipos de dispositivos incluyen Multicooker, olla a presión, licuadora y microondas. 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 para el dispositivo.

Esta característica no controla el tiempo de cocción ni la temperatura de cocción. Consulta Temporizador y TemperaturaControl 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 el manejo de 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	Predeterminados para ciertos tipos de comida.
`[item, ...]`	Objeto	Ajuste predeterminado de comida.
`food_preset_name`	String	Obligatorio. Nombre interno del ajuste predeterminado de comida, 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. Son sinónimos de nombres predeterminados para cada idioma compatible.
`[item, ...]`	Objeto	Nombre de la comida.
`synonym`	Matriz	Obligatorio. Los sinónimos del ajuste predeterminado deben incluir formas singulares y plurales, si corresponde.
`[item, ...]`	String	Nombre del sinónimo preestablecido.
`lang`	String	Obligatorio. Código de idioma (ISO 639-1). Consulta los idiomas compatibles.

Ejemplos

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

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

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 el manejo de intents QUERY, consulta Entrega de intents.

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

Ejemplos

¿Se cocina mi horno?

{
  "currentCookingMode": "BAKE"
}

¿Qué se está cocinando en la olla de arroz en este momento?

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

Dispositivo COMMANDS

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 el manejo de intents EXECUTE, consulta Entrega de intents.

`action.devices.commands.Cook`

Inicia o deja de cocinar.

Parámetros

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

Ejemplos

Comience a hornear 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"
  }
}

Empiece a cocinar 2 tazas de arroz blanco en la olla de arroz.

{
  "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 fraccionada para este ajuste predeterminado de comida, 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.