โหมดประหยัดแบตเตอรี่ตามกิจวัตร

Android 10 เปิดตัวตัวเลือกการตั้งเวลาโหมดประหยัดแบตเตอรี่ที่ชื่อตามกิจวัตร ตัวเลือกนี้ช่วยให้แอปที่ OEM เลือกสามารถส่งสัญญาณไปยังระบบเพื่อกำหนดเวลาโหมดประหยัดแบตเตอรี่ได้อย่างชาญฉลาดยิ่งขึ้น ตัวเลือกนี้ต้องมีการกําหนดค่าและเลือกใช้ได้

การกำหนดค่าอุปกรณ์

ข้อกำหนดของผู้ให้บริการ

หากต้องการแจ้งให้ UI การตั้งค่าทราบว่าอุปกรณ์ได้รับการกําหนดค่าอย่างถูกต้อง ให้ใช้การซ้อนทับการกําหนดค่าเพื่อลบล้างค่า config_batterySaverScheduleProvider ด้วยชื่อแพ็กเกจของแอป

เช่น หากต้องการให้แพ็กเกจแอป com.google.android.apps.turbo ควบคุมการตั้งค่าตามกิจวัตร คุณจะต้องตั้งค่าการกําหนดค่านี้

<string name="config_batterySaverScheduleProvider" translatable="false">
com.google.android.apps.turbo</string>

ตอนนี้โทรศัพท์ควรแสดงตัวเลือกตามกิจวัตร หากต้องการยืนยัน ให้สร้างภาพ แฟลชลงในโทรศัพท์ แล้วไปที่การตั้งค่า > แบตเตอรี่ > โหมดประหยัดแบตเตอรี่ > กําหนดเวลาโหมดประหยัดแบตเตอรี่ ตัวเลือกตามกิจวัตรจะปรากฏขึ้น

เกณฑ์ปิดเริ่มต้น

ช่อง config_dynamicPowerSavingsDefaultDisableThreshold ใหม่จะระบุระดับแบตเตอรี่ที่ระบบจะปิดโหมดประหยัดแบตเตอรี่ หากเปิดใช้โดยตัวกำหนดเวลาตามกิจวัตร ค่าเริ่มต้นของระบบคือ 80% แต่คุณเปลี่ยนแปลงได้

การกำหนดค่าแอป

สิทธิ์

API ที่จําเป็นสําหรับแอปในการเปิดโหมดประหยัดแบตเตอรี่จากแอปได้รับการปกป้องโดยสิทธิ์ android.permission.POWER_SAVER สิทธิ์นี้เป็นสิทธิ์ระดับลายเซ็น/ที่มีสิทธิ์ ดังนั้นให้สิทธิ์นี้แก่แอปที่คุณต้องการให้เรียกใช้โหมดประหยัดพลังงานในprivapp-whitelist

ตัวอย่างการให้สิทธิ์ privapp แก่แอป

<privapp-permissions package="com.google.android.apps.turbo">
   <permission name="android.permission.POWER_SAVER"/>
</privapp-permissions>

หากคุณไม่ได้ให้สิทธิ์นี้ล่วงหน้าแก่เวอร์ชันของแอปในระบบภาพ แอปจะไม่ได้รับสิทธิ์หรือเรียก API อย่างถูกต้อง ระบบจะไม่แสดงความคิดเห็นใดๆ นอกเหนือจากข้อผิดพลาดเกี่ยวกับสิทธิ์ปกติ ดังนั้นโปรดตรวจสอบว่าคุณเรียก API ได้และดูผลลัพธ์

การติดตั้ง

คุณต้องติดตั้งแอปล่วงหน้าในภาพระบบที่มีสิทธิ์ที่จำเป็นเพื่อให้ตามกิจวัตรทำงานได้อย่างถูกต้อง ให้สิทธิ์ POWER_SAVER แก่แอปเดียวเท่านั้นและอนุญาตให้แอปดังกล่าวควบคุม based on routine API ระบบไม่รองรับและไม่ระบุลักษณะการทํางานของฟีเจอร์นี้เมื่อแอปมากกว่า 1 แอปพยายามใช้สิทธิ์และ API

เปิดใช้งานโหมดประหยัดแบตเตอรี่

API

สมมติว่าการตั้งค่าประสบความสําเร็จจนถึงตอนนี้ แอป OEM ที่ระบุไว้ในการกําหนดค่าควรเรียกใช้เมธอดที่เชื่อมโยงใน PowerManager เพื่อเรียกใช้โหมดประหยัดพลังงานได้สําเร็จ

public boolean setDynamicPowerSaveHint(boolean powerSaveHint, int disableThreshold)

หากเปิดใช้ตัวเลือกกำหนดเวลาโหมดประหยัดแบตเตอรี่ตามกิจวัตรและแอปเรียกใช้เมธอดนี้ด้วยค่า true สำหรับ powerSaveHint โหมดประหยัดแบตเตอรี่ก็จะเปิดขึ้น ระบุ disableThreshold เพื่อให้ระบบทราบเปอร์เซ็นต์แบตเตอรี่ที่ปลอดภัยที่จะปิดโหมดประหยัดแบตเตอรี่ได้ในกรณีที่แอปสื่อสารกับระบบไม่ได้

API นี้จะขึ้นอยู่กับการลบล้างของผู้ใช้และการหยุดโหมดประหยัดแบตเตอรี่ชั่วคราวในลักษณะเดียวกับโหมดประหยัดแบตเตอรี่อัตโนมัติตามเปอร์เซ็นต์ ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบเกี่ยวกับ API

หากต้องการยืนยันว่ามีการเรียก API สำเร็จ ให้ค้นหาการตั้งค่าส่วนกลางเพื่อยืนยันว่าการตั้งค่าแบ็กกิ้งมีการเปลี่ยนแปลงค่าตามการเรียก API

ตัวอย่างเช่น หากผู้ใช้เลือกโหมดประหยัดแบตเตอรี่ตามปกติและแอปเรียกใช้ setDynamicPowerSaveHint(true, 10) การตั้งค่าส่วนกลางควรมีค่าดังนี้

automatic_power_save_mode: 1
dynamic_power_savings_disable_threshold: 10
dynamic_power_savings_enabled: 1

หากเรียกใช้ setDynamicPowerSaveHint(false, 25) ค่าควรเป็นดังนี้

automatic_power_save_mode: 1
dynamic_power_savings_disable_threshold: 25
dynamic_power_savings_enabled: 0

คุณสามารถตรวจสอบค่าเหล่านี้ได้โดยใช้คําสั่ง adb นี้

adb shell settings get global <setting-name>

การยืนยัน

ไม่มีการยืนยันฟีเจอร์นี้โดยอัตโนมัติเนื่องจากไม่มีวิธีที่จะทราบลักษณะการทำงานที่ OEM จะใช้เพื่อตัดสินใจว่าควรเปิดใช้งานโหมดประหยัดแบตเตอรี่ตามปกติเมื่อใด ดังนั้น OEM จึงมีหน้าที่รับผิดชอบในการทดสอบการผสานรวมเพื่อให้แน่ใจว่าลักษณะการทำงานเป็นไปตามความคาดหวัง โดยเฉพาะอย่างยิ่ง ให้ยืนยันว่าอุปกรณ์สามารถดำเนินการต่อไปนี้ได้

• ผู้ใช้เลือกตามเปอร์เซ็นต์ใน UI กำหนดเวลาของโหมดประหยัดแบตเตอรี่ แล้วเลือก 15% โหมดประหยัดแบตเตอรี่ควรเปิดโดยอัตโนมัติเมื่อแบตเตอรี่เหลือ 15% เท่านั้น
• ผู้ใช้เลือกตามกิจวัตรใน UI การตั้งเวลาโหมดประหยัดแบตเตอรี่ เมื่อแอปเรียก API ด้วย true ระบบจะเปิดโหมดประหยัดแบตเตอรี่ นอกจากนี้ โหมดประหยัดแบตเตอรี่จะปิดโดยอัตโนมัติหากอุปกรณ์ชาร์จจนเต็มตามเกณฑ์ที่ระบุไว้และถอดปลั๊กออก
• ผู้ใช้เลือกไม่มีใน UI กำหนดเวลาโหมดประหยัดแบตเตอรี่ โหมดประหยัดแบตเตอรี่ไม่ควรเปิดโดยอัตโนมัติ
• หากแอปเปิดโหมดประหยัดแบตเตอรี่และผู้ใช้ลบล้างโหมดประหยัดแบตเตอรี่ด้วยตนเองให้ปิดอีกครั้ง (โดยใช้การตั้งค่าด่วน การตั้งค่า ฯลฯ) โหมดดังกล่าวควรปิดอยู่จนกว่าผู้ใช้จะเปิดโหมดดังกล่าวอีกครั้งด้วยตนเองหรือเสียบปลั๊กอุปกรณ์