สคีมาลักษณะการทำอาหารของ Smart Home

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

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

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

ATTRIBUTES ของอุปกรณ์

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

Attributes	Type	คำอธิบาย
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 ได้ที่Fulfillment Intent

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

ตัวอย่าง

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

{
  "currentCookingMode": "BAKE"
}

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

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

COMMANDS ของอุปกรณ์

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

action.devices.commands.Cook

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

พารามิเตอร์

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