Smart Home Cook 特徵結構定義

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	說明裝置中目前的烹飪 (來自 `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`	布林	必要。 True 代表開始烹飪，設為 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 - 使用者要求的裝置不支援預設食物。