智慧型居家烹飪火車結構定義
action.devices.traits.Cook
- 這個屬性涵蓋可透過多種食物預設和支援的烹調模式烹調食物的裝置。
這些裝置類型的範例包括 Multicooker、Pressco coooker、Blender 和 Microwave。烹飪指令可能包含食物的數量和名稱,例如「兩杯棕米」,「棕米」是裝置的食物預設。
這個特性無法處理烹飪時間或烹飪溫度。 詳情請參閱 Timer 和 TemperatureControl。
裝置屬性
具有此特性的裝置可能會在 SYNC
作業中回報下列屬性。如要進一步瞭解如何處理 SYNC
意圖,請參閱意圖執行要求一文。
屬性 | 類型 | 說明 |
---|---|---|
supportedCookingModes |
陣列 |
必填。 這部裝置支援的烹飪模式。 |
[item, ...] |
字串 |
烹飪模式。 支援的值:
|
foodPresets |
陣列 |
預設特定類型的食物。 |
[item, ...] |
物件 |
食物預設。 |
food_preset_name |
字串 |
必填。 食物預設內部名稱,將用於指令和狀態。此名稱不容易使用,且適用於所有語言。 |
supported_units |
陣列 |
必填。 包含裝置針對特定食物支援的所有單位。 |
[item, ...] |
字串 |
支援的單位。 支援的值:
|
food_synonyms |
陣列 |
必填。 每種支援的語言的預設設定名稱同義詞。 |
[item, ...] |
物件 |
食物名稱。 |
synonym |
陣列 |
必填。 預設的同義詞應包括單數與複數形式 (如果適用的話)。 |
[item, ...] |
字串 |
預設同義詞名稱。 |
lang |
字串 |
必填。 語言代碼 (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" } ] } ] }
裝置狀態:STATE
具有此特性的實體可能會在 QUERY
作業中回報下列狀態。如要進一步瞭解如何處理 QUERY
意圖,請參閱意圖執行要求一文。
州 | 類型 | 說明 |
---|---|---|
currentCookingMode |
字串 |
必填。 從 |
currentFoodPreset |
字串 |
從 |
currentFoodQuantity |
Number |
定義與 |
currentFoodUnit |
字串 |
從 |
範例
我的烤箱是否烹煮?
{ "currentCookingMode": "BAKE" }
我目前在電鍋上煮什麼料理?
{ "currentCookingMode": "COOK", "currentFoodPreset": "brown_rice", "currentFoodQuantity": 2, "currentFoodUnit": "CUPS" }
裝置指令
具有此特性的裝置可能會在 EXECUTE
作業中回應下列指令。如要進一步瞭解如何處理 EXECUTE
意圖,請參閱意圖執行要求一文。
action.devices.commands.Cook
開始或停止烹飪。
參數
參數 | 類型 | 說明 |
---|---|---|
start |
布林 |
必填。 設為 True 可開始烹飪,傳回 False 可停止目前的烹飪模式。 |
cookingMode |
字串 |
已針對 |
foodPreset |
字串 |
使用者要求的食物預設名稱 (來自 |
quantity |
Number |
使用者要求的食物數量。 |
unit |
字串 |
|
範例
開始烤箱。
{ "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" } }
裝置錯誤:ERRORS
請參閱錯誤和例外狀況的完整清單。deviceDoorOpen
- 裝置的門打開了。deviceLidOpen
- 裝置的上蓋已開啟。fractionalAmountNotSupported
- 使用者已為這個食物預設要求進行小計,但裝置並不支援該數量。amountAboveLimit
- 使用者要求的數量超過上限。unknownFoodPreset
- 使用者要求裝置不支援食物選擇。