Android 10 memperkenalkan opsi jadwal penghemat baterai yang disebut berdasarkan rutinitas . Opsi ini memungkinkan aplikasi yang dipilih oleh OEM untuk memberikan sinyal ke sistem untuk penjadwalan penghemat baterai yang lebih cerdas. Opsi ini memerlukan konfigurasi, dan bersifat opsional untuk diterapkan.
Konfigurasi perangkat
Spesifikasi penyedia
Untuk memberi tahu UI Pengaturan bahwa perangkat dikonfigurasi dengan benar, gunakan overlay konfigurasi Anda untuk mengganti nilai config_batterySaverScheduleProvider dengan nama paket aplikasi Anda.
Misalnya, jika Anda ingin paket aplikasi com.google.android.apps.turbo untuk mengontrol berdasarkan pengaturan rutin , maka Anda akan menetapkan nilai konfigurasi ini:
<string name="config_batterySaverScheduleProvider" translatable="false">
com.google.android.apps.turbo</string>
Sekarang telepon harus menunjukkan opsi berdasarkan rutinitas . Untuk memverifikasi, buat gambar Anda, flash ke ponsel, dan navigasikan ke Pengaturan > Baterai > Penghemat Baterai > Jadwal Penghemat Baterai . Opsi berdasarkan rutinitas akan muncul.
ambang batas default
Bidang config_dynamicPowerSavingsDefaultDisableThreshold yang baru menentukan tingkat baterai di mana sistem mematikan penghemat baterai, jika diaktifkan oleh penjadwal rutin . Default sistem adalah 80%, tetapi Anda dapat mengubahnya.
Konfigurasi aplikasi
Izin
API yang diperlukan aplikasi untuk mengaktifkan penghemat baterai dari aplikasi dilindungi oleh izin android.permission.POWER_SAVER . Ini adalah izin tanda tangan/hak istimewa, jadi berikan aplikasi yang Anda inginkan untuk dapat memicu penghemat baterai izin ini di privapp-whitelist Anda.
Contoh pemberian izin privapp ke aplikasi:
<privapp-permissions package="com.google.android.apps.turbo">
<permission name="android.permission.POWER_SAVER"/>
</privapp-permissions>
Jika Anda tidak memberikan izin ini sebelumnya ke versi aplikasi pada citra sistem, aplikasi tidak dapat memperoleh izin atau memanggil API dengan benar. Sistem tidak memberikan umpan balik apa pun di luar kesalahan izin biasa, jadi pastikan Anda dapat memanggil API dan mengamati efeknya.
Instalasi
Agar berdasarkan rutinitas berfungsi dengan baik, Anda harus menginstal aplikasi sebelumnya pada citra sistem dengan izin yang diperlukan. Berikan hanya satu aplikasi izin POWER_SAVER dan izinkan untuk mengontrol berdasarkan API rutin . Perilaku fitur saat lebih dari satu aplikasi mencoba menggunakan izin dan API tidak didukung dan tidak ditentukan.
Memicu penghemat baterai
Lebah
Dengan asumsi penyiapan berhasil sejauh ini, aplikasi OEM yang ditentukan dalam konfigurasi harus berhasil memanggil metode terkait di PowerManager untuk memicu penghemat baterai:
public boolean setDynamicPowerSaveHint(boolean powerSaveHint, int disableThreshold)
Jika opsi berdasarkan jadwal penghemat baterai rutin diaktifkan dan aplikasi memanggil metode ini dengan nilai true untuk powerSaveHint , maka penghemat baterai akan menyala. Tentukan disableThreshold sehingga jika aplikasi tidak dapat berkomunikasi dengan sistem, sistem masih mengetahui persentase baterai yang aman untuk menonaktifkan penghemat baterai.
API ini tunduk pada penggantian pengguna dan penghemat baterai yang ditunda dengan cara yang sama seperti penghemat baterai otomatis berbasis persentase. Lihat dokumentasi API untuk informasi selengkapnya.
Untuk memverifikasi bahwa API berhasil dipanggil, setelan kueri global untuk memverifikasi bahwa setelan pencadangan mengubah nilai sesuai dengan panggilan API .
Misalnya, jika pengguna memilih mode penghemat baterai rutin dan aplikasi memanggil setDynamicPowerSaveHint(true, 10) , pengaturan global harus memiliki nilai berikut:
automatic_power_save_mode: 1
dynamic_power_savings_disable_threshold: 10
dynamic_power_savings_enabled: 1
Jika Anda kemudian memanggil setDynamicPowerSaveHint(false, 25) , nilainya harus:
automatic_power_save_mode: 1
dynamic_power_savings_disable_threshold: 25
dynamic_power_savings_enabled: 0
Anda dapat memeriksa nilai-nilai ini menggunakan perintah adb ini:
adb shell settings get global <setting-name>
Verifikasi
Tidak ada cara otomatis untuk memverifikasi fitur ini karena tidak ada cara untuk mengetahui perilaku apa yang akan digunakan OEM untuk memutuskan kapan harus memicu mode penghemat baterai rutin. Oleh karena itu, OEM bertanggung jawab untuk menguji integrasi mereka untuk memastikan bahwa perilaku tersebut memenuhi harapan. Secara khusus, verifikasi bahwa perangkat dapat memenuhi tugas-tugas berikut:
- Pengguna memilih berdasarkan persentase di UI jadwal penghemat baterai dan memilih 15%. Penghemat baterai harus menyala secara otomatis HANYA ketika mencapai baterai 15%.
- Pengguna memilih berdasarkan rutinitas di UI jadwal penghemat baterai. Saat aplikasi memanggil API dengan
true, penghemat baterai menyala. Selain itu, penghemat baterai mati secara otomatis jika perangkat diisi daya ke tingkat ambang batas yang ditunjukkan dan dicabut. - Pengguna tidak memilih apa pun di UI jadwal penghemat baterai. Penghemat baterai TIDAK PERNAH menyala secara otomatis.
- Jika aplikasi mengaktifkan penghemat baterai dan pengguna secara manual mengganti penghemat baterai untuk mati lagi (menggunakan Pengaturan Cepat, Pengaturan, dll.), itu harus TETAP MATI sampai pengguna menyalakannya kembali secara manual atau mencolokkan perangkat.