สคีมา Smart Home Cook Trait

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

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

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

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

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

แอตทริบิวต์	Type	คำอธิบาย
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) ดูภาษาที่รองรับ

ตัวอย่าง

อุปกรณ์ที่มีโหมดการทําอาหารเพียง 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"
        }
      ]
    }
  ]
}

อุปกรณ์ STATES

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

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

ตัวอย่าง

เตาอบเปิดอยู่หรือเปล่า

{
  "currentCookingMode": "BAKE"
}

ตอนนี้หม้อหุงข้าวทําอะไรอยู่

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

อุปกรณ์ COMMANDS

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

action.devices.commands.Cook

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

พารามิเตอร์

พารามิเตอร์	Type	คำอธิบาย
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 - ผู้ใช้ขอให้อุปกรณ์ตั้งค่าอาหารล่วงหน้าไว้ล่วงหน้า