รองรับอุปกรณ์ไร้แบตเตอรี่

หน้านี้อธิบายวิธีที่ Android จัดการกับผลิตภัณฑ์ที่มีแบตเตอรี่แบบถอดได้หรือไม่มีแบตเตอรี่ภายใน อุปกรณ์หลังจะเชื่อมต่อกับแหล่งพลังงานภายนอกแทน เช่น เต้ารับไฟฟ้ากระแสสลับหรือพอร์ต USB บนอุปกรณ์อื่น

มีแบตเตอรี่อยู่หรือไม่?

แอปพลิเคชันอาจใช้รหัสต่อไปนี้เพื่อตรวจสอบว่าอุปกรณ์มีแบตเตอรี่อยู่หรือไม่:

```
final Intent batteryInfo = registerReceiver(null, new
IntentFilter(Intent.ACTION_BATTERY_CHANGED));

return batteryInfo.getBooleanExtra(BatteryManager.EXTRA_PRESENT, true);
```

พฤติกรรมของอุปกรณ์ที่ไม่มีแบตเตอรี่

หาก Android ตรวจไม่พบอุปกรณ์แบตเตอรี่สำหรับผลิตภัณฑ์ของคุณ ระบบจะใช้ค่าเริ่มต้นที่เกี่ยวข้องกับแบตเตอรี่ต่อไปนี้ โปรดทราบว่าค่าเริ่มต้นมีการเปลี่ยนแปลงในรุ่น Android 9 ตารางนี้แสดงความแตกต่าง

สถานะแบตเตอรี่	Android 9 ขึ้นไป	Android 8.1 และต่ำกว่า
ปัจจุบัน	เท็จ	จริง
สถานะ	ไม่รู้จัก	กำลังชาร์จ
ความจุที่เหลืออยู่	0	100%
สุขภาพ	ไม่รู้จัก	ดี
สถานะออนไลน์ของเครื่องชาร์จ AC	ไม่ดัดแปลง	บังคับให้เป็นจริง

ผู้ผลิตอาจเปลี่ยนการตั้งค่าเริ่มต้นโดยใช้ไดรเวอร์เคอร์เนล power_supply หรือ Health HAL

Android 9 ขึ้นไป

Android 9 ลบโค้ดก่อนหน้านี้บางส่วนสำหรับอุปกรณ์ไร้แบตเตอรี่ที่แสร้งทำเป็นว่าแบตเตอรี่มีอยู่ โดยค่าเริ่มต้น กำลังชาร์จอยู่ที่ 100% และมีสุขภาพที่ดีด้วยการอ่านค่าอุณหภูมิปกติบนเทอร์มิสเตอร์

API เฟรมเวิร์กส่วนใหญ่ที่จัดการกับข้อมูลนี้ยังคงจัดการกับสถานการณ์ทั่วไปได้เหมือนเดิม: ระบบจะถือว่ากำลัง ชาร์จ (ซึ่งก็คือไม่ทำงานโดยใช้พลังงานแบตเตอรี่) และจะไม่ถือว่าแบตเตอรี่เหลือน้อย หากอินเทอร์เฟซผู้ใช้วาดไอคอนแบตเตอรี่ ไอคอนจะปรากฏขึ้นพร้อมเครื่องหมายอัศเจรีย์ และเปอร์เซ็นต์แบตเตอรี่จะแสดงเป็น 0% แต่เครื่องจะไม่ปิดตัวลงเนื่องจากแบตเตอรีเหลือน้อย และงานที่ต้องชาร์จหรือแบตดีๆ จะถูกกำหนดเวลาไว้

Android 8.1 และต่ำกว่า

เนื่องจากไม่ทราบสถานะแบตเตอรี่ API เฟรมเวิร์กของ Android จะถือว่าระบบกำลัง ชาร์จ (หรือไม่ทำงานโดยใช้พลังงานแบตเตอรี่) และจะไม่ถือว่าแบตเตอรี่เหลือน้อย หากอินเทอร์เฟซผู้ใช้แสดงไอคอนแบตเตอรี่ ไอคอนจะปรากฏขึ้นพร้อมเครื่องหมายอัศเจรีย์ และเปอร์เซ็นต์แบตเตอรี่จะแสดงเป็น 0% แต่เครื่องจะไม่ปิดตัวลงเนื่องจากแบตเตอรีเหลือน้อย และงานที่ต้องชาร์จหรือแบตดีๆ จะถูกกำหนดเวลาไว้

การดำเนินการ

รหัสเริ่มต้นของ Android 9 อาจทำงานได้อย่างถูกต้องสำหรับอุปกรณ์ของคุณ แต่ขอแนะนำให้ทำการเปลี่ยนแปลงเคอร์เนลหรือ HAL เพื่อให้สอดคล้องกับสถานะพลังงานและแบตเตอรี่สำหรับผลิตภัณฑ์ของคุณอย่างถูกต้องตามที่อธิบายไว้ข้างต้น หาก Android 9 ขึ้นไปตรวจไม่พบอุปกรณ์ชาร์จ คลาสพาวเวอร์ซัพพลายของ Linux ตามค่าเริ่มต้นที่ชาร์จทุกประเภท (AC, USB, Wireless) จะมีสถานะ ออฟไลน์ หากเครื่องชาร์จทั้งหมดออฟไลน์แต่ตรวจไม่พบอุปกรณ์แบตเตอรี่ ระบบจะยังถือว่ากำลังชาร์จในลักษณะที่ชาร์จจากภายนอก ไม่ใช่พลังงานแบตเตอรี่ ตามที่อธิบายไว้ก่อนหน้านี้

หากผลิตภัณฑ์ของคุณไม่มีแบตเตอรี่และเชื่อมต่อกับแหล่งพลังงานเสมอ วิธีที่ดีที่สุดคือใช้ไดรเวอร์ เครื่องชาร์จ คลาส Linux kernel power_supply สำหรับแหล่งจ่ายไฟ AC หรือ USB ที่ตั้งค่าแอตทริบิวต์ sysfs ออนไลน์ true หรือคุณสามารถกำหนดค่าคุณสมบัติออนไลน์ของเครื่องชาร์จ AC ใน Health HAL สำหรับอุปกรณ์ของคุณ เมื่อต้องการทำเช่นนี้ ให้ใช้ Health HAL ตามที่อธิบายไว้ใน Implementing Health 2.0

Health::getHealthInfo() แบบกำหนดเองนี้ใช้ Health::getHealthInfo() เวอร์ชันที่กำหนดเอง ซึ่งจะแก้ไขค่าของ BatteryProperties.chargerAcOnline = true

ในการเริ่มต้น ให้คัดลอกไฟล์ hardware/interfaces/health/2.0/default/Health.cpp ไปยังการใช้งาน Health HAL ของคุณเอง และแก้ไขตาม Health 2.0 README