Esquema de trait de cocción de casas inteligentes

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

Algunos ejemplos de estos tipos de dispositivos son Multicooker, Pressure cooker, Blender y Microwave. Los comandos de cocción 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 ni la temperatura de cocción. Consulta Timer y TemperatureControl para obtener más información.

Dispositivo ATTRIBUTES

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 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 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 comida.

[item, ...] Objeto

Ajuste predeterminado de comida.

food_preset_name String

Obligatorio.

Nombre interno del ajuste predeterminado de comida, que se usará en los comandos y los estados Es posible que este nombre no sea fácil de usar y se comparta en todos los idiomas.

supported_units Matriz

Obligatorio.

Contiene todas las unidades compatibles con 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 del alimento.

synonym Matriz

Obligatorio.

Los sinónimos del ajuste predeterminado deben incluir formas singulares y plurales, si corresponde.

[item, ...] String

Nombre del sinónimo predeterminado.

lang String

Obligatorio.

Es el 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 cómo controlar los intents QUERY, consulta Entrega de intents.

Estados Tipo Descripción
currentCookingMode String

Obligatorio.

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

currentFoodPreset String

Describe la cocción actual de la comida en el dispositivo, a partir de la lista del atributo foodPresets. Solo se puede informar un alimento. Si no hay ningún alimento seleccionado, la configuración se debe establecer en NINGUNO.

currentFoodQuantity Número

Define la cantidad actual de comida asociada con la 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

La unidad asociada con el currentFoodQuantity, de la lista de atributos supported_units.

Ejemplos

¿Mi horno está cocinando?

{
  "currentCookingMode": "BAKE"
}

¿Qué se está cocinando en mi 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 los intents 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.

Verdadero para comenzar a cocinar, Falso para detener el modo de cocción actual.

cookingMode String

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

foodPreset String

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

quantity Número

La cantidad de comida solicitada por el usuario.

unit String

La unidad asociada con quantity, del atributo supported_units.

Ejemplos

Comienza a hornear en el horno

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

Deja de hornear el horno

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

Empiece 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"
  }
}

ERRORS de dispositivos

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