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