สคีมา Smart Home Cook Trait
action.devices.traits.Cook
- ลักษณะเฉพาะนี้แสดงบนอุปกรณ์ที่สามารถปรุงอาหารได้โดยอิงตามค่าที่กําหนดล่วงหน้าของอาหารและโหมดการทําอาหารที่รองรับ
ตัวอย่างประเภทอุปกรณ์เหล่านี้ ได้แก่ หม้ออเนกประสงค์ หม้ออบความดัน เครื่องปั่น และไมโครเวฟ คําสั่งทําอาหารอาจมีจํานวนและชื่ออาหาร เช่น "ข้าวกล้อง 2 ถ้วย" โดย "ข้าวสีน้ําตาล" เป็นอาหารที่กําหนดไว้ล่วงหน้าสําหรับอุปกรณ์
ลักษณะนี้จัดการเวลาในการปรุงหรืออุณหภูมิในการปรุงไม่ได้ ดูข้อมูลเพิ่มเติมได้ที่ตัวจับเวลาและ TemperatureControl
แอตทริบิวต์ของอุปกรณ์
อุปกรณ์ที่มีลักษณะเฉพาะนี้อาจรายงานแอตทริบิวต์ต่อไปนี้เป็นส่วนหนึ่งของการดําเนินการ SYNC
หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ SYNC
โปรดดูการดําเนินการ Intent
แอตทริบิวต์ | Type | คำอธิบาย |
---|---|---|
supportedCookingModes |
อาร์เรย์ |
ต้องระบุ โหมดการทําอาหารที่อุปกรณ์นี้รองรับ |
[item, ...] |
สตริง |
โหมดการทําอาหาร ค่าที่รองรับ:
|
foodPresets |
อาร์เรย์ |
ค่าที่กําหนดล่วงหน้าสําหรับอาหารบางประเภท |
[item, ...] |
ออบเจ็กต์ |
อาหารที่กําหนดล่วงหน้า |
food_preset_name |
สตริง |
ต้องระบุ ชื่อภายในของชุดอาหารล่วงหน้า ซึ่งจะใช้ในคําสั่งและสถานะ ชื่อนี้อาจใช้งานยากและแชร์ได้ในทุกภาษา |
supported_units |
อาร์เรย์ |
ต้องระบุ มีทุกหน่วยที่อุปกรณ์รองรับสําหรับอาหารบางอย่าง |
[item, ...] |
สตริง |
หน่วยที่รองรับ ค่าที่รองรับ:
|
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 |
สตริง |
ต้องระบุ อธิบายโหมดการทําอาหารในปัจจุบันที่ตั้งไว้ในอุปกรณ์ จากรายการแอตทริบิวต์ |
currentFoodPreset |
สตริง |
อธิบายวิธีการปรุงอาหารปัจจุบันในอุปกรณ์จากรายการแอตทริบิวต์ |
currentFoodQuantity |
Number |
กําหนดจํานวนปัจจุบันของการปรุงอาหารที่เชื่อมโยงกับ |
currentFoodUnit |
สตริง |
หน่วยที่เชื่อมโยงกับ |
ตัวอย่าง
เตาอบเปิดอยู่หรือเปล่า
{ "currentCookingMode": "BAKE" }
ตอนนี้หม้อหุงข้าวทําอะไรอยู่
{ "currentCookingMode": "COOK", "currentFoodPreset": "brown_rice", "currentFoodQuantity": 2, "currentFoodUnit": "CUPS" }
อุปกรณ์ COMMANDS
อุปกรณ์ที่มีลักษณะเฉพาะนี้อาจตอบสนองต่อคําสั่งต่อไปนี้ในฐานะส่วนหนึ่งของการดําเนินการ EXECUTE
หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ EXECUTE
โปรดดูการดําเนินการ Intent
action.devices.commands.Cook
เริ่มหรือหยุดทําอาหาร
พารามิเตอร์
พารามิเตอร์ | Type | คำอธิบาย |
---|---|---|
start |
บูลีน |
ต้องระบุ "จริง" เพื่อเริ่มทําอาหาร "เท็จ" เพื่อหยุดโหมดการทําอาหารปัจจุบัน |
cookingMode |
สตริง |
ขอโหมดการทําอาหารสําหรับอุปกรณ์จากแอตทริบิวต์ |
foodPreset |
สตริง |
ชื่อของค่าที่กําหนดล่วงหน้าสําหรับอาหารที่ผู้ใช้ขอจากแอตทริบิวต์ |
quantity |
Number |
ปริมาณอาหารที่ผู้ใช้ร้องขอ |
unit |
สตริง |
หน่วยที่เชื่อมโยงกับ |
ตัวอย่าง
เริ่มอบในเตาอบ
{ "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
- ผู้ใช้ขอให้อุปกรณ์ตั้งค่าอาหารล่วงหน้าไว้ล่วงหน้า