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

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 รายงานได้เพียงโหมดเดียวเท่านั้น หากยังไม่ได้เลือกโหมด ควรตั้งค่านี้เป็น "ไม่มี"

currentFoodPreset String

food_preset_name ของการปรุงอาหารปัจจุบันในอุปกรณ์ จากแอตทริบิวต์ foodPresets รายงานอาหารได้เพียง 1 รายการเท่านั้น หากยังไม่ได้เลือกอาหาร ควรตั้งค่านี้เป็น "ไม่มี"

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 - ผู้ใช้ขอค่าอาหารที่กำหนดล่วงหน้าซึ่งอุปกรณ์ไม่รองรับ