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:
|
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:
|
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 |
currentFoodPreset |
String |
Describe la cocción de alimentos actual en el dispositivo, a partir de la lista de atributos |
currentFoodQuantity |
Número |
Define la cantidad actual de cocina de alimentos asociada con el |
currentFoodUnit |
String |
La unidad asociada con el |
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 |
foodPreset |
String |
Es el nombre del ajuste predeterminado de comida que solicitó el usuario desde el atributo |
quantity |
Número |
Indica la cantidad de comida que solicitó el usuario. |
unit |
String |
La unidad asociada con el |
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.