智慧型住宅烹飪特徵

action.devices.traits.Cook - 這種特徵屬於可根據各種食物預設選項和支援的烹飪模式烹調食物的裝置。

例如 Multicooker、Pressure cooker、 Blender和Microwave。食譜指令可以包含餐點，例如「兩杯棕色米」，其中「棕色米」為裝置的預設設定

這個特徵無法控制烹飪時間或烹飪溫度。請參閱《Timer》和《TemperatureControl》瞭解詳情

裝置屬性

具備這項特徵的裝置可能會回報下列資料：在 SYNC 作業中使用屬性變更。學習如要進一步瞭解如何處理 SYNC 意圖，請參閱意圖執行要求。

屬性	類型	說明
`supportedCookingModes`	陣列	必要。這部裝置支援的烹飪模式。
`[item, ...]`	String	烹飪模式，支援的值： `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`	String	必要。食物預設設定的內部名稱，會在指令和狀態中使用。這個名稱可能不易使用，且適用於所有語言。
`supported_units`	陣列	必要。包含裝置針對特定食物支援的所有單位。
`[item, ...]`	String	支援的單位。支援的值： `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, ...]`	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 意圖，請參閱意圖執行要求。

州	類型	說明
`currentCookingMode`	String	必要。說明裝置目前設定的烹飪模式，來自 `supportedCookingModes` 屬性。系統只能回報一個模式。如果目前未選取任何模式，則應設為「NONE」。
`currentFoodPreset`	String	裝置中目前烹飪的 `food_preset_name` (來自 `foodPresets` 屬性)。系統只能回報一項食物。如果目前未選取任何食物，則應設為「無」。
`currentFoodQuantity`	Number	定義與 `currentFoodUnit` 相關聯的目前烹飪量 (如果指定數量)。如果目前沒有正在烹飪，或沒有與此食物預設設定相關的數量，請勿回報。
`currentFoodUnit`	String	與 `currentFoodQuantity` 相關聯的單位，來自預設選項的 `supported_units` 清單。

範例

我的烤箱烹飪嗎？

{
  "currentCookingMode": "BAKE"
}

我的米飯料理怎麼了？

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

裝置指令

具備這種特徵的裝置可能會回應下列問題做為 EXECUTE 作業的一部分。學習如要進一步瞭解如何處理 EXECUTE 意圖，請參閱意圖執行要求。

`action.devices.commands.Cook`

開始或停止烹飪。

參數

參數	類型	說明
`start`	布林值	必要。設為「是」開始烹飪，設為「false」則表示停止目前烹飪模式。
`cookingMode`	String	透過 `supportedCookingModes` 屬性要求的裝置烹調模式。
`foodPreset`	String	使用者要求的預設食物名稱，來自 `foodPresets` 屬性。
`quantity`	Number	使用者要求的食物數量。
`unit`	String	與 `quantity` 相關聯的單位 (來自 `supported_units` 屬性)。

範例

開始在烤箱中烘焙

{
  "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 - 使用者要求取得裝置不支援的預設食物。