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

สคีมา Smart Home Cook Trait

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

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

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

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

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

แอตทริบิวต์ ประเภท คำอธิบาย
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 ได้ที่การดําเนินการโดย Intent

รัฐ ประเภท คำอธิบาย
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 ได้ที่การดําเนินการโดย Intent

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