สคีมา Smart Home Coit Trait

action.devices.traits.Cook - ลักษณะเฉพาะนี้เป็นของอุปกรณ์ทําอาหารตามรูปแบบอาหารล่วงหน้าและโหมดการทําอาหารที่รองรับ

ตัวอย่างอุปกรณ์ประเภทนี้ ได้แก่ หม้ออเนกประสงค์ หม้อต้มแรงดัน เครื่องปั่น และไมโครเวฟ คําสั่งทําอาหารอาจมีจํานวนและชื่ออาหาร เช่น "ข้าวกล้อง 2 ถ้วย" โดยที่ "ข้าวน้ําตาล" เป็นอาหารล่วงหน้าที่กําหนดสําหรับอุปกรณ์

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

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

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

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

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

ตัวอย่าง

เตาอบของฉันอยู่หรือเปล่า

{
  "currentCookingMode": "BAKE"
}

ตอนนี้หม้อหุงข้าวคืออะไร

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

คําสั่งของอุปกรณ์

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

action.devices.commands.Cook

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

พารามิเตอร์

พารามิเตอร์	ประเภท	คำอธิบาย
start	บูลีน	ต้องระบุ เป็นจริงเพื่อเริ่มทําอาหาร เท็จเพื่อหยุดโหมดทําอาหารปัจจุบัน
cookingMode	สตริง	ขอโหมดการทําอาหารสําหรับอุปกรณ์จากแอตทริบิวต์ supportedCookingModes แล้ว
foodPreset	สตริง	ชื่อของค่าที่กําหนดล่วงหน้าของอาหารที่ผู้ใช้ขอจากแอตทริบิวต์ foodPresets
quantity	Number	ปริมาณอาหารที่ผู้ใช้ขอ
unit	สตริง	หน่วยที่เชื่อมโยงกับ 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"
  }
}

อุปกรณ์ ERRORS

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

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