歡迎使用 Google Home 開發人員中心,探索全新功能,瞭解如何開發智慧住宅動作。注意:請繼續在「動作」控制台中建立動作。
透過集合功能整理內容 你可以依據偏好儲存及分類內容。

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

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

這些裝置類型的範例包括 MulticookerPressco coookerBlenderMicrowave。烹飪指令可能包含食物的數量和名稱,例如「兩杯棕米」,「棕米」是裝置的食物預設。

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

裝置屬性

具有此特性的裝置可能會在 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 - 使用者要求裝置不支援食物選擇。