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

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