Giản đồ Trait cho nhà thông minh

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

Ví dụ về các loại thiết bị này bao gồm Multicooker, Pressure cooker, Blender và Microwave. Các lệnh nấu có thể bao gồm số lượng và tên món ăn, chẳng hạn như "Hai tách gạo lức", trong đó "gạo nâu" là chế độ đặt sẵn thực phẩm trên 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 quá trình SYNC. Để tìm hiểu thêm về cách xử lý ý định SYNC, vui lòng xem phần Thực hiện ý định.

Thuộc tính	Loại	Nội dung mô tả
supportedCookingModes	Mảng	Bắt buộc. Các chế độ nấu được thiết bị này hỗ trợ.
[item, ...]	Chuỗi	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	Giá trị đặt trước cho một số loại món ăn.
[item, ...]	Đối tượng	Chế độ ăn.
food_preset_name	Chuỗi	Bắt buộc. Tên nội bộ của chế độ cài đặ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, ...]	Chuỗi	Đơ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ế độ cài đặt sẵn trong mỗi 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 với giá trị đặt trước, phải bao gồm cả dạng số ít và số nhiều (nếu có).
[item, ...]	Chuỗi	Tên có từ đồng nghĩa được đặt trước.
lang	Chuỗi	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ế độ nấu nào được đặt sẵn.

{
  "supportedCookingModes": [
    "BAKE"
  ]
}

Thiết bị có nhiều chế độ nấu và chế độ cài đặt sẵn về đồ ă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 của 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 trong thao tác QUERY. Để tìm hiểu thêm về cách xử lý ý định QUERY, vui lòng xem phần Thực hiện ý định.

Tiểu bang	Loại	Mô tả
currentCookingMode	Chuỗi	Bắt buộc. Mô tả chế độ nấu hiện tại được đặt trên thiết bị, từ danh sách thuộc tính supportedCookingModes. Chỉ có thể báo cáo một chế độ. Nếu không có chế độ nào hiện được chọn, bạn phải đặt chế độ này thành NONE.
currentFoodPreset	Chuỗi	Từ danh sách thuộc tính foodPresets, mô tả quá trình nấu món ăn đang diễn ra trong thiết bị. Chỉ có thể báo cáo một loại thực phẩm. Nếu không có thực phẩm nào đang được chọn, bạn phải đặt giá trị này thành NONE.
currentFoodQuantity	Number	Xác định thời gian nấu thức ăn hiện tại 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 nào đang nấu hoặc nếu không có số lượng nào liên quan đến giá trị đặt trước này.
currentFoodUnit	Chuỗi	Đơn vị liên kết với currentFoodQuantity, từ danh sách thuộc tính supported_units.

Ví dụ

Lò của tôi đang nướng chưa?

{
  "currentCookingMode": "BAKE"
}

Nồi cơm của tôi đang nấu những món gì?

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

Lệnh trên thiết bị

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

action.devices.commands.Cook

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

Thông số

Thông số	Loại	Nội dung 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	Chuỗi	Đã yêu cầu chế độ nấu cho thiết bị bằng thuộc tính supportedCookingModes.
foodPreset	Chuỗi	Tên của chế độ ăn đặt sẵn 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	Chuỗi	Đơn vị liên kết với quantity, từ thuộc tính supported_units.

Ví dụ

Bắt đầu nướng bánh trong lò nướng của tôi.

{
  "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 cốc cơm trắng trong nồi cơm của tôi.

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

Thiết bị ERRORS

Xem danh sách đầy đủ lỗi và trường hợp 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 số lượng nhỏ cho giá trị đặt trước này, nhưng thiết bị này không hỗ trợ chế độ đó.
• 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 giá trị đặt trước không được thiết bị hỗ trợ.