Esquema de las características de Smart Home Cook
action.devices.traits.Cook
: Esta característica pertenece a los dispositivos que pueden cocinar según diferentes ajustes predeterminados y modos de cocción admitidos.
Algunos ejemplos de estos tipos de dispositivos incluyen Multicooker, olla de presión, licuadora y microonda. Los comandos de cocina pueden incluir la cantidad y el nombre de la comida, como "Dos tazas de arroz integral", en el que "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 Control de temperatura 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 cómo manejar los 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 |
Ajustes predeterminados para ciertos tipos de comida |
[item, ...] |
Objeto |
Ajustes predeterminados de comida. |
food_preset_name |
String |
Obligatorio. Nombre interno del ajuste predeterminado, 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. Sinónimos de nombres de alimentos para el ajuste predeterminado en cada idioma admitido. |
[item, ...] |
Objeto |
Nombre de la comida. |
synonym |
Matriz |
Obligatorio. Los sinónimos del ajuste predeterminado deben incluir formas en singular y plural, si corresponde. |
[item, ...] |
String |
Nombre de sinónimos preestablecido. |
lang |
String |
Obligatorio. Código de idioma (ISO 639-1). Consulte los idiomas compatibles. |
Ejemplos
Dispositivo con solo un modo de cocción y sin ajuste predeterminado.
{ "supportedCookingModes": [ "BAKE" ] }
Dispositivo con múltiples 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 manejar los intents QUERY
, consulta Entrega de intents.
Estados | Tipo | Descripción |
---|---|---|
currentCookingMode |
String |
Obligatorio. Describe el modo de cocción actual establecido en el dispositivo de la lista de atributos |
currentFoodPreset |
String |
Describe la cocina actual en el dispositivo, a partir de la lista de atributos |
currentFoodQuantity |
Número |
Define la cantidad actual de comida cocinada asociada con el |
currentFoodUnit |
String |
La unidad asociada con el |
Ejemplos
¿Se cocina el horno?
{ "currentCookingMode": "BAKE" }
¿Qué se está cocinando en la arrocera?
{ "currentCookingMode": "COOK", "currentFoodPreset": "brown_rice", "currentFoodQuantity": 2, "currentFoodUnit": "CUPS" }
Dispositivo COMMAND
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 manejar los intents EXECUTE
, consulta Entrega de intents.
action.devices.commands.Cook
Iniciar o detener la cocina
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 |
Se solicitó el modo de cocina del dispositivo desde el atributo |
foodPreset |
String |
Es el nombre del ajuste predeterminado que solicitó el usuario del atributo |
quantity |
Número |
La cantidad de comida que solicitó el usuario. |
unit |
String |
La unidad asociada con el |
Ejemplos
Empieza a hornear en el horno.
{ "command": "action.devices.commands.Cook", "params": { "start": true, "cookingMode": "BAKE" } }
Deja de hornear en el horno.
{ "command": "action.devices.commands.Cook", "params": { "start": false, "cookingMode": "BAKE" } }
Comience 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" } }
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 fraccionaria para este ajuste predeterminado, 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.