Giản đồ đặc điểm nấu ăn trong 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 trước 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 món ăn, chẳng hạn như "Hai cốc gạo lứt", trong đó "gạo lứt" là một món ăn được đặt trước cho thiết bị.

Thuộc tính 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 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 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 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ế độ cài đặt trước cho một số loại thực phẩm.
[item, ...] Đối tượng

Chế độ ăn được đặt sẵn.
food_preset_name String

Bắt buộc.

Tên nội bộ của chế độ nấu ăn đặt trước, 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ả 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.

Từ đồng nghĩa của tên món ăn cho chế độ đặt trước trong từng ngôn ngữ được hỗ trợ.
[item, ...] Đối tượng

Tên món ăn.
synonym Mảng

Bắt buộc.

Từ đồng nghĩa cho chế độ cài đặt trước, 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.
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 đặt trước.

{
  "supportedCookingModes": [
    "BAKE"
  ]
}

Thiết bị có nhiều chế độ nấu và chế độ cài đặt trước cho món ăn.

{
  "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 thực hiện thao tác 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 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 giá trị này thành KHÔNG.
currentFoodPreset String

food_preset_name của thực phẩm hiện đang nấu trong thiết bị, 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ó món ăn nào được chọn, bạn nên đặt giá trị này thành KHÔNG.
currentFoodQuantity Number

Xác định lượng thức ăn hiện tại được liên kết với currentFoodUnit, nếu bạn chỉ định số lượng. Bạn không nên báo cáo nếu không có món ăn nào đang nấu hoặc nếu không có số lượng liên quan đến giá trị đặt trước về món ăn này.
currentFoodUnit String

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

Ví dụ

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

{
  "currentCookingMode": "BAKE"
}

Nồi cơm đang nấu món gì?

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

LỆNH 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 đây trong quá trình hoạt động EXECUTE. Để tìm hiểu thêm về cách xử lý ý định EXECUTE, hãy xem bài viết 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

Đã yêu cầu chế độ nấu cho thiết bị, từ thuộc tính supportedCookingModes.
foodPreset String

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

Số lượng thức ăn 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ò nướng.

{
  "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 đủ lỗi và ngoại lệ.
  • deviceDoorOpen – 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 giá trị đặt trước về thức ăn này, nhưng thiết bị này không hỗ trợ một lượng thức ăn đó.
  • 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 ăn mà thiết bị không hỗ trợ.