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, ...] |
Cadena |
Modo de cocción. Valores admitidos:
|
foodPresets |
Matriz |
Ajustes predeterminados para ciertos tipos de comida. |
[item, ...] |
Objeto |
Ajuste predeterminado de comida. |
food_preset_name |
Cadena |
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, ...] |
Cadena |
Unidad compatible. Valores admitidos:
|
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, ...] |
Cadena |
Nombre del sinónimo predeterminado. |
lang |
Cadena |
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 |
Cadena |
Obligatorio. Describe el modo de cocción establecido en el dispositivo, a partir de la lista del atributo |
currentFoodPreset |
Cadena |
Describe la cocción actual de la comida en el dispositivo, a partir de la lista del atributo |
currentFoodQuantity |
Número |
Define la cantidad actual de comida asociada con la |
currentFoodUnit |
Cadena |
La unidad asociada con el |
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 |
Cadena |
Modo de cocción solicitado para el dispositivo, desde el atributo |
foodPreset |
Cadena |
Es el nombre del ajuste predeterminado de comida que solicitó el usuario, del atributo |
quantity |
Número |
La cantidad de comida solicitada por el usuario. |
unit |
Cadena |
La unidad asociada con |
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.