Esquema del rasgo de cocción de casa inteligente
action.devices.traits.Cook
: Este rasgo pertenece a los dispositivos que pueden cocinar alimentos según varios ajustes predeterminados y modos de cocción admitidos.
Entre los ejemplos de estos tipos de dispositivos, se incluyen Multicooker, Pressure cooker, Blender y Microwave. Los comandos de cocina pueden incluir la cantidad y el nombre de la comida, como "Dos tazas de arroz integral", donde "arroz integral" es un ajuste predeterminado de comida para el dispositivo.
Este rasgo 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 este rasgo pueden informar los siguientes atributos como parte de la operación SYNC
. Para obtener más información sobre cómo controlar intents de SYNC
, consulta Entrega de intents.
Atributos | Tipo | Descripción |
---|---|---|
supportedCookingModes |
Matriz |
Obligatorio. Son los modos de cocción que admite este dispositivo. |
[item, ...] |
String |
Modo de cocción Valores admitidos:
|
foodPresets |
Matriz |
Ajustes predeterminados para ciertos tipos de alimentos |
[item, ...] |
Objeto |
Es un ajuste predeterminado de comida. |
food_preset_name |
String |
Obligatorio. Nombre interno del ajuste predeterminado 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 admitidas por el dispositivo para un alimento específico. |
[item, ...] |
String |
Unidad admitida. Valores admitidos:
|
food_synonyms |
Matriz |
Obligatorio. Son los sinónimos del nombre de la comida para el ajuste predeterminado en cada idioma admitido. |
[item, ...] |
Objeto |
Nombre del alimento. Se requiere al menos un elemento con un valor de |
synonym |
Matriz |
Obligatorio. Sinónimos del ajuste predeterminado, que deben incluir las formas en singular y plural, si corresponde. |
[item, ...] |
String |
Es el nombre del sinónimo predeterminado. Se requiere al menos un elemento con un valor de |
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 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" } ] } ] }
ESTADOS del dispositivo
Las entidades con este rasgo pueden informar los siguientes estados como parte de la operación QUERY
. Para obtener más información sobre cómo controlar intents de QUERY
, consulta Entrega de intents.
Estados | Tipo | Descripción |
---|---|---|
currentCookingMode |
String |
Obligatorio. Describe el modo de cocción actual establecido en el dispositivo, a partir del atributo |
currentFoodPreset |
String |
Es el |
currentFoodQuantity |
Número |
Define la cantidad actual de comida que se está cocinando asociada con |
currentFoodUnit |
String |
Es la unidad asociada con el |
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 este rasgo pueden responder a los siguientes comandos como parte de la operación EXECUTE
. Para obtener más información sobre cómo controlar intents de 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. Es verdadero para comenzar a cocinar y falso para detener el modo de cocción actual. |
cookingMode |
String |
Modo de cocción solicitado para el dispositivo, del atributo |
foodPreset |
String |
Es el nombre del ajuste predeterminado de comida que solicitó el usuario, del atributo |
quantity |
Número |
Cantidad de comida que solicitó el usuario. |
unit |
String |
Es la unidad asociada con el |
Ejemplos
Comienza a hornear en mi horno.
{ "command": "action.devices.commands.Cook", "params": { "start": true, "cookingMode": "BAKE" } }
Dejar de hornear en mi horno
{ "command": "action.devices.commands.Cook", "params": { "start": false, "cookingMode": "BAKE" } }
Comienza 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ó una cantidad fraccionaria para este ajuste predeterminado de comida, pero el dispositivo no la admite.amountAboveLimit
: El usuario solicitó una cantidad superior al máximo.unknownFoodPreset
: El usuario solicitó un ajuste predeterminado de comida que no admite el dispositivo.