Lược đồ đặc điểm nấu ăn của nhà thông minh

action.devices.traits.Cook – Đặc điểm này thuộc về những thiết bị có thể nấu ăn theo nhiều chế độ nấu ăn đặt sẵn và chế độ nấu ăn được hỗ trợ.

Ví dụ về các loại thiết bị này bao gồm Multicooker, Pressure cooker, Blender và Microwave. Lệnh nấu ăn có thể bao gồm số lượng và tên của thực phẩm, chẳng hạn như "Hai cốc gạo lứt", trong đó "gạo lứt" là một chế độ cài đặt sẵn cho thực phẩm của thiết bị.

Đặc điểm này không xử lý thời gian nấu hoặc nhiệt độ nấu. Hãy xem Timer và TemperatureControl để biết thêm thông tin.

THUỘC TÍNH của thiết bị

Các thiết bị có đặc điểm này có thể báo cáo các thuộc tính sau đây trong thao tác SYNC. Để tìm hiểu thêm về cách xử lý ý định SYNC, hãy xem phần Thực hiện ý định.

Thuộc tính Loại Mô tả
supportedCookingModes Mảng

Bắt buộc.

Các chế độ nấu ăn mà thiết bị này hỗ trợ.
[item, ...] String

Chế độ nấu ăn.

Các giá trị được hỗ trợ:

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 Mảng

Chế độ đặt sẵn cho một số loại thực phẩm.
[item, ...] Đối tượng

Chế độ nấu sẵn.
food_preset_name String

Bắt buộc.

Tên nội bộ của chế độ đặt sẵn cho thực phẩm, sẽ được dùng trong các lệnh và trạng thái. Tên này có thể không thân thiện với người dùng và được dùng chung cho tất cả các ngôn ngữ.
supported_units Mảng

Bắt buộc.

Chứa tất cả các đơn vị mà thiết bị hỗ trợ cho một loại thực phẩm cụ thể.
[item, ...] String

Đơn vị được hỗ trợ.

Các giá trị được hỗ trợ:

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 Mảng

Bắt buộc.

Các từ đồng nghĩa của tên thực phẩm cho chế độ đặt sẵn bằng từng ngôn ngữ được hỗ trợ.
[item, ...] Đối tượng

Tên thực phẩm. Bạn phải có ít nhất một mặt hàng có giá trị lang là en để cung cấp ngôn ngữ dự phòng.
synonym Mảng

Bắt buộc.

Từ đồng nghĩa cho chế độ đặt sẵn, phải bao gồm cả dạng số ít và số nhiều (nếu có).
[item, ...] String

Tên từ đồng nghĩa đặt sẵn. Bạn phải có ít nhất một mặt hàng có giá trị lang là en để cung cấp ngôn ngữ dự phòng.
lang String

Bắt buộc.

Mã ngôn ngữ (ISO 639-1). Xem các ngôn ngữ được hỗ trợ.

Ví dụ

Thiết bị chỉ có một chế độ nấu và không có chế độ cài sẵn.

{
  "supportedCookingModes": [
    "BAKE"
  ]
}

Thiết bị có nhiều chế độ nấu và chế độ cài sẵn cho thực phẩm.

{
  "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"
        }
      ]
    }
  ]
}

TRẠNG THÁI thiết bị

Các thực thể có đặc điểm này có thể báo cáo các trạng thái sau đây trong quá trình hoạt động QUERY. Để tìm hiểu thêm về cách xử lý ý định QUERY, hãy xem phần Thực hiện ý định.

Tiểu bang Loại Mô tả
currentCookingMode String

Bắt buộc.

Mô tả chế độ nấu ăn hiện tại được đặt trên thiết bị, từ thuộc tính supportedCookingModes. Bạn chỉ có thể báo cáo một chế độ. Nếu hiện không có chế độ nào được chọn, bạn nên đặt chế độ này thành NONE.
currentFoodPreset String

food_preset_name của món ăn đang nấu trong thiết bị, lấy từ thuộc tính foodPresets. Bạn chỉ có thể báo cáo một loại thực phẩm. Nếu hiện không có thực phẩm nào được chọn, bạn nên đặt giá trị này thành NONE.
currentFoodQuantity Number

Xác định lượng thực phẩm đang nấu hiện tại được liên kết với currentFoodUnit, nếu bạn đã chỉ định số lượng. Không nên báo cáo nếu hiện không có món nào đang nấu hoặc nếu không có số lượng nào liên kết với chế độ cài đặt sẵn này cho thực phẩm.
currentFoodUnit String

Đơn vị được liên kết với currentFoodQuantity, trong danh sách supported_units của chế độ cài đặt sẵn.

Ví dụ

Lò nướng của tôi có đang nấu không?

{
  "currentCookingMode": "BAKE"
}

Nồi cơm điện của tôi đang nấu gì vậy?

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

Lệnh cho thiết bị

Các thiết bị có đặc điểm này có thể phản hồi các lệnh sau trong thao tác EXECUTE. Để tìm hiểu thêm về cách xử lý ý định EXECUTE, hãy xem phần Thực hiện ý định.

action.devices.commands.Cook

Bắt đầu hoặc dừng nấu ăn.

Thông số

Thông số Loại Mô tả
start Boolean

Bắt buộc.

True để bắt đầu nấu, false để dừng chế độ nấu hiện tại.
cookingMode String

Chế độ nấu ăn được yêu cầu cho thiết bị, từ thuộc tính supportedCookingModes.
foodPreset String

Tên của chế độ cài đặt sẵn về thực phẩm mà người dùng yêu cầu, từ thuộc tính foodPresets.
quantity Number

Số lượng thực phẩm mà người dùng yêu cầu.
unit String

Đơn vị liên kết với quantity, từ thuộc tính supported_units.

Ví dụ

Bắt đầu nướng trong lò.

{
  "command": "action.devices.commands.Cook",
  "params": {
    "start": true,
    "cookingMode": "BAKE"
  }
}

Dừng nướng trong lò của tôi.

{
  "command": "action.devices.commands.Cook",
  "params": {
    "start": false,
    "cookingMode": "BAKE"
  }
}

Bắt đầu nấu 2 chén gạo trắng trong nồi cơm điện.

{
  "command": "action.devices.commands.Cook",
  "params": {
    "start": true,
    "cookingMode": "COOK",
    "foodPreset": "white_rice",
    "quantity": 2,
    "unit": "CUPS"
  }
}

LỖI thiết bị

Xem danh sách đầy đủ các lỗi và trường hợp ngoại lệ.
  • deviceDoorOpen – Cửa của thiết bị đang mở.
  • deviceLidOpen – Nắp của thiết bị đang mở.
  • fractionalAmountNotSupported – Người dùng yêu cầu một lượng nhỏ cho chế độ cài sẵn này, nhưng thiết bị này không hỗ trợ.
  • amountAboveLimit – Người dùng yêu cầu số lượng vượt quá mức tối đa.
  • unknownFoodPreset – Người dùng yêu cầu một chế độ nấu không được thiết bị hỗ trợ.