สคีมาของลักษณะการทำอาหารของสมาร์ทโฮม
action.devices.traits.Cook
- ลักษณะนี้เป็นของอุปกรณ์ที่สามารถทำอาหารตามค่าอาหารที่กำหนดล่วงหน้าและโหมดการทำอาหารที่รองรับ
ตัวอย่างประเภทของอุปกรณ์เหล่านี้ ได้แก่ Multicooker, Pressure cooker, Blender และ Microwave คำสั่งทำอาหารอาจมีจำนวนและชื่อของ อาหาร เช่น "ข้าวกล้อง 2 ถ้วย" กับ "ข้าวกล้อง" คือค่าอาหารที่กำหนดล่วงหน้าสำหรับอุปกรณ์
ลักษณะนี้ไม่ได้ใช้กับเวลาปรุงหรืออุณหภูมิในการปรุง โปรดดูTimerและTemperatureControl เพื่อดูข้อมูลเพิ่มเติม
แอตทริบิวต์ของอุปกรณ์
อุปกรณ์ที่มีลักษณะนี้อาจรายงานสิ่งต่อไปนี้
เป็นส่วนหนึ่งของการดำเนินการ SYNC
เพื่อเรียนรู้
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent SYNC
ได้ที่
การจำหน่าย Intent
Attributes | ประเภท | คำอธิบาย |
---|---|---|
supportedCookingModes |
อาร์เรย์ |
ต้องระบุ โหมดการทำอาหารที่อุปกรณ์นี้รองรับ |
[item, ...] |
String |
โหมดทำอาหาร ค่าที่รองรับ
|
foodPresets |
อาร์เรย์ |
ค่าที่กำหนดล่วงหน้าสำหรับอาหารบางประเภท |
[item, ...] |
ออบเจ็กต์ |
ค่าอาหารที่กำหนดล่วงหน้า |
food_preset_name |
String |
ต้องระบุ ชื่อภายในของค่าอาหารล่วงหน้า ซึ่งจะใช้ในคำสั่งและสถานะ ชื่อนี้อาจใช้ไม่ได้สำหรับผู้ใช้และใช้ร่วมกันได้ในทุกภาษา |
supported_units |
อาร์เรย์ |
ต้องระบุ มีทุกหน่วยที่อุปกรณ์รองรับสำหรับอาหารที่เฉพาะเจาะจง |
[item, ...] |
String |
หน่วยที่รองรับ ค่าที่รองรับ
|
food_synonyms |
อาร์เรย์ |
ต้องระบุ คำพ้องความหมายของชื่ออาหารสำหรับค่าที่กำหนดล่วงหน้าในแต่ละภาษาที่รองรับ |
[item, ...] |
ออบเจ็กต์ |
ชื่ออาหาร |
synonym |
อาร์เรย์ |
ต้องระบุ คำพ้องความหมายของค่าที่กำหนดล่วงหน้าควรรวมทั้งรูปเอกพจน์และพหูพจน์ หากมี |
[item, ...] |
String |
ชื่อคำพ้องความหมายที่กำหนดล่วงหน้า |
lang |
String |
ต้องระบุ รหัสภาษา (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 |
String |
ต้องระบุ อธิบายโหมดการทำอาหารปัจจุบันที่ตั้งค่าไว้ในอุปกรณ์จากแอตทริบิวต์ |
currentFoodPreset |
String |
|
currentFoodQuantity |
Number |
กำหนดปริมาณการทำอาหารในปัจจุบันที่เชื่อมโยงกับ |
currentFoodUnit |
String |
หน่วยที่เชื่อมโยงกับ |
ตัวอย่าง
เตาอบของฉันกำลังทำอาหารอยู่ไหม
{ "currentCookingMode": "BAKE" }
ตอนนี้หม้อหุงข้าวทำอะไรอยู่
{ "currentCookingMode": "COOK", "currentFoodPreset": "brown_rice", "currentFoodQuantity": 2, "currentFoodUnit": "CUPS" }
คำสั่งอุปกรณ์
อุปกรณ์ที่มีลักษณะนี้อาจตอบสนองต่อสิ่งต่อไปนี้
เป็นส่วนหนึ่งของการดำเนินการ EXECUTE
เพื่อเรียนรู้
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent EXECUTE
ได้ที่
การจำหน่าย Intent
action.devices.commands.Cook
เริ่มหรือหยุดทำอาหาร
พารามิเตอร์
พารามิเตอร์ | ประเภท | คำอธิบาย |
---|---|---|
start |
บูลีน |
ต้องระบุ "จริง" เพื่อเริ่มทำอาหาร "เท็จ" เพื่อหยุดโหมดการทำอาหารปัจจุบัน |
cookingMode |
String |
ขอโหมดการทำอาหารสำหรับอุปกรณ์จากแอตทริบิวต์ |
foodPreset |
String |
ชื่อของค่าอาหารล่วงหน้าที่ผู้ใช้ขอจากแอตทริบิวต์ |
quantity |
Number |
ปริมาณอาหารที่ผู้ใช้ขอ |
unit |
String |
หน่วยที่เชื่อมโยงกับ |
ตัวอย่าง
เริ่มอบในเตาอบ
{ "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" } }
ข้อผิดพลาดของอุปกรณ์
ดูรายการทั้งหมดของ ข้อผิดพลาดและข้อยกเว้นdeviceDoorOpen
- ประตูอุปกรณ์เปิดอยู่deviceLidOpen
- ฝาอุปกรณ์เปิดอยู่fractionalAmountNotSupported
- ผู้ใช้ขอจำนวนเงินเป็นเศษส่วนสำหรับรายการนี้ ค่าอาหารล่วงหน้า แต่อุปกรณ์นี้ไม่รองรับamountAboveLimit
- ผู้ใช้ขอจำนวนที่เกินขีดจำกัดunknownFoodPreset
- ผู้ใช้ขอค่าอาหารที่กำหนดล่วงหน้าซึ่งอุปกรณ์ไม่รองรับ