สคีมาของลักษณะคุกของสมาร์ทโฮม

action.devices.traits.Cook - ลักษณะนี้ใช้กับอุปกรณ์ที่ปรุงอาหารตามการตั้งค่าอาหารล่วงหน้าและโหมดการปรุงอาหารที่รองรับได้

ตัวอย่างประเภทอุปกรณ์เหล่านี้ ได้แก่ Multicooker, Pressure cooker, Blender และ Microwave คำสั่งการปรุงอาหารอาจระบุปริมาณและชื่ออาหาร เช่น "ข้าวกล้อง 2 ถ้วย" โดยที่ "ข้าวกล้อง" คืออาหารที่ตั้งค่าล่วงหน้าสำหรับอุปกรณ์

ลักษณะนี้ไม่ได้ใช้กับเวลาปรุงหรืออุณหภูมิในการปรุง ดูข้อมูลเพิ่มเติมได้ที่ Timer และ TemperatureControl

แอตทริบิวต์อุปกรณ์

อุปกรณ์ที่มีลักษณะนี้อาจรายงานแอตทริบิวต์ต่อไปนี้ซึ่งเป็นส่วนหนึ่งของการดำเนินการ SYNC ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent SYNC ได้ที่การดำเนินการตาม Intent

Attributes	ประเภท	คำอธิบาย
supportedCookingModes	อาร์เรย์	ต้องระบุ โหมดการทำอาหารที่อุปกรณ์นี้รองรับ
[item, ...]	String	โหมดการทำอาหาร ค่าที่รองรับ 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	String	ต้องระบุ ชื่อภายในของอาหารที่กำหนดล่วงหน้า ซึ่งจะใช้ในคำสั่งและสถานะ ชื่อนี้อาจไม่เหมาะกับผู้ใช้และจะใช้ได้กับทุกภาษา
supported_units	อาร์เรย์	ต้องระบุ มีทุกหน่วยที่อุปกรณ์รองรับสำหรับอาหารที่เฉพาะเจาะจง
[item, ...]	String	หน่วยที่รองรับ ค่าที่รองรับ 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, ...]	String	ชื่อคำพ้องความหมายที่กำหนดล่วงหน้า
lang	String	ต้องระบุ รหัสภาษา (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"
        }
      ]
    }
  ]
}

สถานะอุปกรณ์

เอนทิตีที่มีลักษณะนี้อาจรายงานสถานะต่อไปนี้เป็นส่วนหนึ่งของการดำเนินการ QUERY ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent QUERY ได้ที่การดำเนินการตาม Intent

รัฐ	ประเภท	คำอธิบาย
currentCookingMode	String	ต้องระบุ อธิบายโหมดการปรุงอาหารปัจจุบันที่ตั้งค่าไว้ในอุปกรณ์จากแอตทริบิวต์ supportedCookingModes รายงานได้เพียง 1 โหมดเท่านั้น หากไม่ได้เลือกโหมดใดเลยในตอนนี้ คุณควรตั้งค่านี้เป็น "ไม่มี"
currentFoodPreset	String	food_preset_name ของอาหารที่กำลังทำอยู่ในอุปกรณ์จากแอตทริบิวต์ foodPresets รายงานได้เพียงอาหารรายการเดียว หากไม่ได้เลือกอาหารใดๆ ไว้ ควรตั้งค่าเป็น "ไม่มี"
currentFoodQuantity	Number	กำหนดปริมาณอาหารที่กำลังทำอยู่ซึ่งเชื่อมโยงกับ currentFoodUnit หากมีการระบุปริมาณ ไม่ควรรายงานหากไม่มีอาหารกำลังทำอยู่ หรือหากไม่มีปริมาณที่เชื่อมโยงกับอาหารที่กำหนดล่วงหน้านี้
currentFoodUnit	String	หน่วยที่เชื่อมโยงกับ currentFoodQuantity จากรายการ supported_units ของค่าที่กำหนดล่วงหน้า

ตัวอย่าง

เตาอบกำลังทำอาหารอยู่ไหม

{
  "currentCookingMode": "BAKE"
}

ตอนนี้กำลังทำอาหารอะไรในหม้อหุงข้าว

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

คำสั่งอุปกรณ์

อุปกรณ์ที่มีลักษณะนี้อาจตอบสนองต่อคําสั่งต่อไปนี้ซึ่งเป็นส่วนหนึ่งของการดำเนินการ EXECUTE ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent EXECUTE ได้ที่การดำเนินการตาม Intent

action.devices.commands.Cook

เริ่มหรือหยุดทำอาหาร

พารามิเตอร์

พารามิเตอร์	ประเภท	คำอธิบาย
start	บูลีน	ต้องระบุ จริงเพื่อเริ่มทำอาหาร และเท็จเพื่อหยุดโหมดการทำอาหารปัจจุบัน
cookingMode	String	โหมดการปรุงอาหารที่ขอสำหรับอุปกรณ์จากแอตทริบิวต์ supportedCookingModes
foodPreset	String	ชื่อของอาหารที่กำหนดล่วงหน้าซึ่งผู้ใช้ขอจากแอตทริบิวต์ foodPresets
quantity	Number	จำนวนอาหารตามที่ผู้ใช้ขอ
unit	String	หน่วยที่เชื่อมโยงกับ quantity จากแอตทริบิวต์ supported_units

ตัวอย่าง

เริ่มอบในเตาอบ

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

ข้อผิดพลาดของอุปกรณ์

ดูรายการข้อผิดพลาดและข้อยกเว้นทั้งหมด

• deviceDoorOpen - ประตูอุปกรณ์เปิดอยู่
• deviceLidOpen - ฝาของอุปกรณ์เปิดอยู่
• fractionalAmountNotSupported - ผู้ใช้ขอจำนวนค่าอาหารล่วงหน้าเป็นเศษส่วน แต่อุปกรณ์นี้ไม่รองรับ
• amountAboveLimit - ผู้ใช้ขอจำนวนที่เกินจำนวนสูงสุด
• unknownFoodPreset - ผู้ใช้ขอการตั้งค่าอาหารล่วงหน้าที่อุปกรณ์ไม่รองรับ