สคีมา Trait ของ EnergyStorage ของสมาร์ทโฮม
action.devices.traits.EnergyStorage
- ลักษณะนี้เป็นของอุปกรณ์ที่สามารถเก็บพลังงานไว้ในแบตเตอรี่และอาจนำไปชาร์จใหม่ได้ หรืออุปกรณ์ที่ชาร์จอุปกรณ์อื่นได้
ATTRIBUTES ของอุปกรณ์
อุปกรณ์ที่มีลักษณะเช่นนี้อาจรายงานแอตทริบิวต์ต่อไปนี้ซึ่งเป็นส่วนหนึ่งของการดำเนินการ SYNC
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent SYNC
ได้ที่Fulfillment Intent
Attributes | Type | คำอธิบาย |
---|---|---|
queryOnlyEnergyStorage |
บูลีน |
ต้องระบุ เป็นจริงหากอุปกรณ์นี้รองรับเฉพาะการค้นหาเกี่ยวกับระดับพลังงานที่จัดเก็บไว้และสถานะการชาร์จที่ใช้งานอยู่ (ขึ้นอยู่กับแอตทริบิวต์ |
energyStorageDistanceUnitForUX |
String |
(ค่าเริ่มต้น: จะใช้ในการตอบกลับผู้ใช้ ค่าที่รองรับ
|
isRechargeable |
บูลีน |
(ค่าเริ่มต้น: ตั้งค่าเป็น "จริง" หากอุปกรณ์นี้แบบชาร์จได้ ข้อความนี้บ่งบอกว่าอุปกรณ์อาจรายงานสถานะ |
ตัวอย่าง
อุปกรณ์แบบชาร์จได้
{ "isRechargeable": true, "queryOnlyEnergyStorage": false }
อุปกรณ์แบบชาร์จได้ที่แสดงระดับการชาร์จปัจจุบันเป็นไมล์
{ "isRechargeable": true, "energyStorageDistanceUnitForUX": "MILES", "queryOnlyEnergyStorage": false }
อุปกรณ์ที่ชาร์จไม่ได้ซึ่งรองรับเฉพาะการรายงานระดับการชาร์จปัจจุบันเท่านั้น
{ "isRechargeable": false, "queryOnlyEnergyStorage": true }
สถานะอุปกรณ์
เอนทิตีที่มีลักษณะนี้อาจรายงานสถานะต่อไปนี้ซึ่งเป็นส่วนหนึ่งของการดำเนินการ QUERY
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent QUERY
ได้ที่Fulfillment Intent
รัฐ | Type | คำอธิบาย |
---|---|---|
descriptiveCapacityRemaining |
String |
ต้องระบุ คำอธิบายเชิงคุณภาพของระดับความจุพลังงาน โปรดทราบว่าข้อมูลนี้มีไว้เพื่อกรณีที่ไม่มีข้อมูลความจุที่เป็นตัวเลข หากมีข้อมูลจำนวนนับด้วย ระบบจะเลือกใช้มากกว่าการอธิบาย หากเป็นไปได้ ค่าที่รองรับ
|
capacityRemaining |
อาร์เรย์ |
อาร์เรย์ของคู่หน่วย/ค่าที่เก็บข้อมูลความจุของพลังงานที่อุปกรณ์มีอยู่ในปัจจุบัน เช่น ตอนนี้ <device> ของฉันมีระยะทางเท่าไร หรือ <device>ฉันชาร์จได้กี่เปอร์เซ็นต์ |
[item, ...] |
ออบเจ็กต์ |
ความจุที่เหลืออยู่ในหน่วยและคู่ค่า |
rawValue |
จำนวนเต็ม |
ต้องระบุ ค่าความจุ |
unit |
String |
ต้องระบุ หน่วยความจุ ค่าที่รองรับ
|
capacityUntilFull |
อาร์เรย์ |
อาร์เรย์ของคู่หน่วย/ค่าที่เก็บข้อมูลความจุไว้จนกว่าอุปกรณ์จะชาร์จเต็ม เช่น ระยะเวลาจนกว่า <device> จะชาร์จเต็ม |
[item, ...] |
ออบเจ็กต์ |
ความจุจนกว่าจะชาร์จ |
rawValue |
จำนวนเต็ม |
ต้องระบุ ค่าความจุ |
unit |
String |
ต้องระบุ หน่วยความจุ ค่าที่รองรับ
|
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" }
COMMANDS ของอุปกรณ์
อุปกรณ์ที่มีลักษณะเช่นนี้อาจตอบสนองต่อคำสั่งต่อไปนี้โดยเป็นส่วนหนึ่งของการดำเนินการ EXECUTE
ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent EXECUTE
ได้ที่Fulfillment Intent
action.devices.commands.Charge
เริ่มหรือหยุดชาร์จ
คำสั่งนี้ต้องใช้แอตทริบิวต์ต่อไปนี้{ "isRechargeable": true }
พารามิเตอร์
พารามิเตอร์ | Type | คำอธิบาย |
---|---|---|
charge |
บูลีน |
ต้องระบุ "จริง" หากต้องการเริ่มชาร์จ ตั้งค่า "เท็จ" เพื่อหยุดชาร์จ |
ตัวอย่าง
คำสั่งเริ่มชาร์จ
{ "command": "action.devices.commands.Charge", "params": { "charge": true } }
คำสั่งหยุดชาร์จ
{ "command": "action.devices.commands.Charge", "params": { "charge": false } }
ข้อผิดพลาดเกี่ยวกับอุปกรณ์
ดูรายการข้อผิดพลาดและข้อยกเว้นทั้งหมดdeviceUnplugged
: ผู้ใช้พยายามชาร์จอุปกรณ์ที่ไม่ได้เสียบปลั๊กอยู่