智能家居烹饪特征特征
action.devices.traits.Cook
- 此特征属于可以根据各种食物预设和受支持的烹饪模式烹饪食物的设备。
这些设备类型的示例包括多功能锅、高压锅、搅拌器和微波炉。烹饪命令可以包含食物的数量和名称,例如“两杯糙米”,其中“糙米”是设备的食品预设。
此特征不处理烹饪时间或烹饪温度。 如需了解详情,请参阅计时器和 TemperatureControl。
设备属性
具有此特征的设备可能会在 SYNC
操作中报告以下属性。如需详细了解如何处理 SYNC
intent,请参阅 intent 执行方式。
属性 | 类型 | 说明 |
---|---|---|
supportedCookingModes |
数组 |
必填。 此设备支持的烹饪模式。 |
[item, ...] |
String |
烹饪模式。 支持的值:
|
foodPresets |
数组 |
特定类型食物的预设。 |
[item, ...] |
对象 |
食物预设。 |
food_preset_name |
String |
必填。 食物预设的内部名称,将在命令和状态中使用。此名称可能不适合用户使用,并且适用于所有语言。 |
supported_units |
数组 |
必填。 包含设备支持特定食物的所有单位。 |
[item, ...] |
String |
支持的单位。 支持的值:
|
food_synonyms |
数组 |
必填。 预设的食品同义词(使用每种受支持的语言)。 |
[item, ...] |
对象 |
食物名称。 |
synonym |
数组 |
必填。 预设的同义词,应包括单复数形式(如果适用)。 |
[item, ...] |
String |
预设同义词名称。 |
lang |
String |
必填。 语言代码 (ISO 639-1)。请参阅支持的语言。 |
示例
仅具有一种烹饪模式且未设置预设的设备。
{ "supportedCookingModes": [ "BAKE" ] }
具有多种烹饪模式和预设食物的设备。
{ "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" } ] } ] }
设备状态
具有此特征的实体可能会在 QUERY
操作中报告以下状态。如需详细了解如何处理 QUERY
intent,请参阅 intent 执行方式。
州 | 类型 | 说明 |
---|---|---|
currentCookingMode |
String |
必填。 通过 |
currentFoodPreset |
String |
通过 |
currentFoodQuantity |
编号 |
定义与 |
currentFoodUnit |
String |
与 |
示例
我的烤箱在做饭吗?
{ "currentCookingMode": "BAKE" }
我目前在电饭煲里做了什么?
{ "currentCookingMode": "COOK", "currentFoodPreset": "brown_rice", "currentFoodQuantity": 2, "currentFoodUnit": "CUPS" }
设备命令
具有此特征的设备可能会在 EXECUTE
操作中响应以下命令。如需详细了解如何处理 EXECUTE
intent,请参阅 intent 执行方式。
action.devices.commands.Cook
开始或停止烹饪。
参数
参数 | 类型 | 说明 |
---|---|---|
start |
Boolean |
必填。 设为 true 时开始烹饪,设为 false 时停止当前的烹饪模式。 |
cookingMode |
String |
通过 |
foodPreset |
String |
用户请求的食品预设名称(来自 |
quantity |
编号 |
用户请求的食品数量。 |
unit |
String |
与 |
示例
开始在烤箱中烘烤。
{ "command": "action.devices.commands.Cook", "params": { "start": true, "cookingMode": "BAKE" } }
停止在烤箱中烘焙。
{ "command": "action.devices.commands.Cook", "params": { "start": false, "cookingMode": "BAKE" } }
开始在电饭锅中煮 2 杯白米。
{ "command": "action.devices.commands.Cook", "params": { "start": true, "cookingMode": "COOK", "foodPreset": "white_rice", "quantity": 2, "unit": "CUPS" } }
设备出错
查看错误和异常的完整列表。deviceDoorOpen
- 设备的门已打开。deviceLidOpen
- 设备的盖子已打开。fractionalAmountNotSupported
- 用户申请了该食物预设的小数部分,但此设备不支持。amountAboveLimit
- 用户请求的数量超出了上限。unknownFoodPreset
- 用户请求了设备不支持的食物预设。