สคีมาของห้องเช่าพลังงานสําหรับสมาร์ทโฮม
action.devices.traits.EnergyStorage
- ลักษณะนี้เป็นของอุปกรณ์ที่ใช้พลังงานในแบตเตอรี่และอาจชาร์จใหม่ได้ หรืออุปกรณ์ที่สามารถชาร์จอุปกรณ์อื่นได้
แอตทริบิวต์อุปกรณ์
อุปกรณ์ที่มีลักษณะเฉพาะนี้อาจรายงานแอตทริบิวต์ต่อไปนี้เป็นส่วนหนึ่งของการดําเนินการ SYNC
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ SYNC
ได้ที่การดําเนินการตามความตั้งใจ
แอตทริบิวต์ | ประเภท | คำอธิบาย |
---|---|---|
queryOnlyEnergyStorage |
บูลีน |
ต้องระบุ เป็นจริงหากอุปกรณ์นี้รองรับการค้นหาเกี่ยวกับระดับพลังงานที่จัดเก็บไว้เท่านั้น โดยจะต้องระบุสถานะการชาร์จที่ใช้งานอยู่ (ขึ้นอยู่กับแอตทริบิวต์ |
energyStorageDistanceUnitForUX |
สตริง |
(ค่าเริ่มต้น: จะใช้ในการตอบกลับผู้ใช้ ค่าที่รองรับมีดังต่อไปนี้
|
isRechargeable |
บูลีน |
(ค่าเริ่มต้น: ตั้งค่าเป็นจริงหากอุปกรณ์นี้ชาร์จได้ใหม่ ซึ่งบ่งชี้ว่าอุปกรณ์อาจรายงานสถานะ |
ตัวอย่าง
อุปกรณ์แบบชาร์จได้
{ "isRechargeable": true, "queryOnlyEnergyStorage": false }
อุปกรณ์แบบชาร์จได้ที่แสดงระดับการชาร์จปัจจุบันเป็นไมล์
{ "isRechargeable": true, "energyStorageDistanceUnitForUX": "MILES", "queryOnlyEnergyStorage": false }
อุปกรณ์ที่ชาร์จไม่ได้ ซึ่งรองรับการรายงานระดับการเรียกเก็บเงินปัจจุบันเท่านั้น
{ "isRechargeable": false, "queryOnlyEnergyStorage": true }
สถานะอุปกรณ์
เอนทิตีที่มีลักษณะเฉพาะนี้อาจรายงานสถานะต่อไปนี้เป็นส่วนหนึ่งของการดําเนินการ QUERY
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ QUERY
ได้ที่การดําเนินการตามความตั้งใจ
รัฐ | ประเภท | คำอธิบาย |
---|---|---|
descriptiveCapacityRemaining |
สตริง |
ต้องระบุ คําอธิบายเชิงคุณภาพของระดับความจุพลังงาน โปรดทราบว่าในกรณีที่ไม่มีข้อมูลความจุที่เป็นตัวเลข หากมีข้อมูลความจุตัวเลขด้วย ระบบจะเลือกใช้มากกว่าการอธิบาย (หากเป็นไปได้) ค่าที่รองรับมีดังต่อไปนี้
|
capacityRemaining |
อาร์เรย์ |
อาร์เรย์ของคู่หน่วย/ค่าที่มีข้อมูลกําลังการผลิตพลังงานที่อุปกรณ์ถืออยู่ เช่น <device> ของฉันมีระยะทางเท่าไร หรืออุปกรณ์ <device> มีเปอร์เซ็นต์การชาร์จเท่าใด |
[item, ...] |
วัตถุ |
ความจุที่เหลืออยู่ในหน่วยหน่วยและค่า |
rawValue |
จำนวนเต็ม |
ต้องระบุ ค่าความจุ |
unit |
สตริง |
ต้องระบุ หน่วยความจุ ค่าที่รองรับมีดังต่อไปนี้
|
capacityUntilFull |
อาร์เรย์ |
อาร์เรย์ของคู่หน่วย/ค่าที่เก็บข้อมูลเกี่ยวกับความจุจนกว่าอุปกรณ์จะชาร์จเต็ม เช่น เวลาจนกว่าจะชาร์จ <device> จนเต็ม |
[item, ...] |
วัตถุ |
ความจุจนกว่าจะชาร์จแล้ว |
rawValue |
จำนวนเต็ม |
ต้องระบุ ค่าความจุ |
unit |
สตริง |
ต้องระบุ หน่วยความจุ ค่าที่รองรับมีดังต่อไปนี้
|
isCharging |
บูลีน |
อุปกรณ์กําลังชาร์จอยู่หรือไม่ |
isPluggedIn |
บูลีน |
อุปกรณ์เสียบปลั๊กอยู่หรือไม่ อุปกรณ์เสียบปลั๊กได้ แต่ไม่ได้ชาร์จอยู่ |
ตัวอย่าง
อุปกรณ์แบบชาร์จได้
{ "descriptiveCapacityRemaining": "HIGH", "capacityRemaining": [ { "rawValue": 36000, "unit": "SECONDS" }, { "rawValue": 90, "unit": "PERCENTAGE" } ], "capacityUntilFull": [ { "rawValue": 120, "unit": "SECONDS" } ], "isCharging": true, "isPluggedIn": true }
อุปกรณ์แบบชาร์จได้ที่แสดงระดับการชาร์จปัจจุบันเป็นไมล์
{ "descriptiveCapacityRemaining": "CRITICALLY_LOW", "capacityRemaining": [ { "rawValue": 12, "unit": "MILES" } ], "capacityUntilFull": [ { "rawValue": 6000, "unit": "SECONDS" } ], "isCharging": true, "isPluggedIn": true }
อุปกรณ์ที่ชาร์จไม่ได้ ซึ่งรองรับการรายงานระดับการชาร์จปัจจุบันเท่านั้น
{ "descriptiveCapacityRemaining": "LOW" }
คําสั่งของอุปกรณ์
อุปกรณ์ที่มีลักษณะเฉพาะนี้อาจตอบสนองต่อคําสั่งต่อไปนี้ซึ่งเป็นส่วนหนึ่งของการดําเนินการ EXECUTE
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ EXECUTE
ได้ที่การดําเนินการตามความตั้งใจ
action.devices.commands.Charge
เริ่มหรือหยุดชาร์จ
คําสั่งนี้ต้องใช้แอตทริบิวต์ต่อไปนี้{ "isRechargeable": true }
พารามิเตอร์
พารามิเตอร์ | ประเภท | คำอธิบาย |
---|---|---|
charge |
บูลีน |
ต้องระบุ จริงจะเริ่มชาร์จ เท็จเพื่อหยุดชาร์จ |
ตัวอย่าง
เริ่มคําสั่งชาร์จ
{ "command": "action.devices.commands.Charge", "params": { "charge": true } }
หยุดคําสั่งชาร์จ
{ "command": "action.devices.commands.Charge", "params": { "charge": false } }
อุปกรณ์ ERRORS
ดูรายการข้อผิดพลาดและข้อยกเว้นทั้งหมดdeviceUnplugged
: ผู้ใช้พยายามชาร์จอุปกรณ์ที่ไม่ได้เสียบปลั๊ก