ยินดีต้อนรับสู่ Google Home Developer Center แหล่งใหม่เรียนรู้วิธีพัฒนาการดําเนินการในบ้านอัจฉริยะ หมายเหตุ: คุณจะสร้างการดําเนินการต่างๆ ต่อไปในคอนโซลการดําเนินการ
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

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