Giản đồ về dấu vết nấu ăn 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 giá trị đặt trước và 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 thực phẩm, chẳng hạn như "Hai cốc gạo lứt", trong đó "gạo nâu" là chế độ ăn được đặt sẵn cho thiết bị.

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

ATTRIBUTE của thiết bị

Những thiết bị có đặc điểm này có thể báo cáo những điều sau trong thao tác SYNC. Để tìm hiểu tìm hiểu thêm về cách xử lý ý định SYNC, hãy xem 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ế độ đặt sẵn 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 được đặt sẵn, 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.

Từ đồng nghĩa của tên thực phẩm với giá trị đặt trước trong mỗi ngôn ngữ được hỗ trợ.
[item, ...] Đối tượng

Tên thực phẩm.
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, ...] String

Tên đặt sẵn từ đồng nghĩa.
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ế độ đặt sẵn.

{
  "supportedCookingModes": [
    "BAKE"
  ]
}

Thiết bị có nhiều chế độ nấu và chế độ nấu ăn đặt sẵ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"
        }
      ]
    }
  ]
}

Thiết bị STATES

Đối tượng có đặc điểm này có thể báo cáo những nội dung sau các trạng thái trong thao tác QUERY. Để tìm hiểu tìm hiểu thêm về cách xử lý ý định QUERY, hãy xem 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. 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 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 thực phẩm. Nếu bạn đang không chọn thực phẩm nào, thì bạn nên đặt giá trị này thành NONE (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ó lượng thức ăn nào liên quan đến giá trị đặt trước 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 của tôi hiện đang nấu gì?

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

lệnh của thiết bị

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

action.devices.commands.Cook

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

Tham số

Tham 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 giá trị đặt trước do người dùng yêu cầu, trong thuộc tính foodPresets.
quantity Number

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 trong thuộc tính supported_units.

Ví dụ

Bắt đầu nướng trong lò 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 toàn bộ danh sách lỗi và ngoại lệ.
  • deviceDoorOpen – Cửa thiết bị đang mở.
  • deviceLidOpen – Nắp thiết bị đang mở.
  • fractionalAmountNotSupported - Người dùng đã yêu cầu một số tiền phân số cho lượt này chế độ ăn đặt trước 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 chế độ nấu ăn mà thiết bị không hỗ trợ.