智慧型居家烹飪火車結構定義

action.devices.traits.Cook - 這個屬性涵蓋可透過多種食物預設和支援的烹調模式烹調食物的裝置。

這些裝置類型的範例包括 Multicooker、Pressco coooker、Blender 和 Microwave。烹飪指令可能包含食物的數量和名稱，例如「兩杯棕米」，「棕米」是裝置的食物預設。

這個特性無法處理烹飪時間或烹飪溫度。 詳情請參閱 Timer 和 TemperatureControl。

裝置屬性

具有此特性的裝置可能會在 SYNC 作業中回報下列屬性。如要進一步瞭解如何處理 SYNC 意圖，請參閱意圖執行要求一文。

屬性	類型	說明
supportedCookingModes	陣列	必填。 這部裝置支援的烹飪模式。
[item, ...]	字串	烹飪模式。 支援的值： UNKNOWN_COOKING_MODE BAKE BEAT BLEND BOIL BREW BROIL CONVECTION_BAKE COOK DEFROST DEHYDRATE FERMENT FRY GRILL KNEAD MICROWAVE MIX PRESSURE_COOK PUREE ROAST SAUTE SLOW_COOK SOUS_VIDE STEAM STEW STIR WARM WHIP
foodPresets	陣列	預設特定類型的食物。
[item, ...]	物件	食物預設。
food_preset_name	字串	必填。 食物預設內部名稱，將用於指令和狀態。此名稱不容易使用，且適用於所有語言。
supported_units	陣列	必填。 包含裝置針對特定食物支援的所有單位。
[item, ...]	字串	支援的單位。 支援的值： UNKNOWN_UNITS NO_UNITS CENTIMETERS CUPS DECILITERS FEET FLUID_OUNCES GALLONS GRAMS INCHES KILOGRAMS LITERS METERS MILLIGRAMS MILLILITERS MILLIMETERS OUNCES PINCH PINTS PORTION POUNDS QUARTS TABLESPOONS TEASPOONS
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	字串	必填。 從 supportedCookingModes 屬性清單中，描述裝置目前的烹飪模式。系統只會回報一種模式。如果目前未選取任何模式，請將其設為 NONE。
currentFoodPreset	字串	從 foodPresets 屬性清單中說明裝置上目前的食物烹飪。您只能回報一項食物。如果目前未選取任何食物，應設為 NONE。
currentFoodQuantity	Number	定義與 currentFoodUnit 相關聯的目前烹飪量 (如果已指定數量)。如果目前未烹調，或者沒有與此食物預設相關的數量，則不應回報。
currentFoodUnit	字串	從 supported_units 屬性清單中與 currentFoodQuantity 相關聯的單位。

範例

我的烤箱是否烹煮？

{
  "currentCookingMode": "BAKE"
}

我目前在電鍋上煮什麼料理？

{
  "currentCookingMode": "COOK",
  "currentFoodPreset": "brown_rice",
  "currentFoodQuantity": 2,
  "currentFoodUnit": "CUPS"
}

裝置指令

具有此特性的裝置可能會在 EXECUTE 作業中回應下列指令。如要進一步瞭解如何處理 EXECUTE 意圖，請參閱意圖執行要求一文。

action.devices.commands.Cook

開始或停止烹飪。

參數

參數	類型	說明
start	布林	必填。 設為 True 可開始烹飪，傳回 False 可停止目前的烹飪模式。
cookingMode	字串	已針對 supportedCookingModes 屬性要求裝置的烹飪模式。
foodPreset	字串	使用者要求的食物預設名稱 (來自 foodPresets 屬性)。
quantity	Number	使用者要求的食物數量。
unit	字串	supported_units 屬性中與「quantity」相關聯的單位。

範例

開始烤箱。

{
  "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 - 使用者要求裝置不支援食物選擇。