Penghemat baterai rutin

Android 10 memperkenalkan opsi jadwal penghemat baterai yang disebut berdasarkan rutinitas. Opsi ini memungkinkan aplikasi yang dipilih oleh OEM 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 Setelan 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 mengontrol setelan berdasarkan rutinitas, Anda harus menetapkan nilai konfigurasi ini:

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

Sekarang ponsel akan menampilkan opsi berdasarkan rutinitas. Untuk memverifikasi, buat gambar, flash ke ponsel, lalu buka Setelan > Baterai > Penghemat Baterai > Jadwal Penghemat Baterai. Opsi berdasarkan rutinitas akan muncul.

Nilai minimum nonaktif

Kolom config_dynamicPowerSavingsDefaultDisableThreshold baru menentukan tingkat baterai saat sistem menonaktifkan penghemat baterai, jika diaktifkan oleh penjadwal berdasarkan rutinitas. 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 izin ini pada aplikasi yang Anda inginkan agar dapat memicu penghemat baterai di privapp-whitelist.

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 terlebih dahulu ke versi aplikasi di image sistem, aplikasi tidak dapat memperoleh izin atau memanggil API dengan benar. Sistem tidak memberikan masukan selain error izin yang biasa, jadi pastikan Anda dapat memanggil API dan mengamati efeknya.

Penginstalan

Agar berdasarkan rutinitas berfungsi dengan baik, Anda harus menginstal aplikasi terlebih dahulu di image sistem dengan izin yang diperlukan. Hanya berikan izin POWER_SAVER untuk satu aplikasi dan izinkan aplikasi mengontrol API berdasarkan rutinitas. Perilaku fitur saat lebih dari satu aplikasi mencoba menggunakan izin dan API tidak didukung dan tidak ditentukan.

Memicu penghemat baterai

API

Dengan asumsi bahwa penyiapan berhasil sejauh ini, aplikasi OEM yang ditentukan dalam konfigurasi akan berhasil memanggil metode terkait di PowerManager untuk memicu penghemat baterai:

public boolean setDynamicPowerSaveHint(boolean powerSaveHint, int disableThreshold)

Jika opsi jadwal penghemat baterai berdasarkan rutinitas diaktifkan dan aplikasi memanggil metode ini dengan nilai true untuk powerSaveHint, penghemat baterai akan diaktifkan. Tetapkan disableThreshold sehingga jika aplikasi tidak dapat berkomunikasi dengan sistem, sistem masih mengetahui persentase baterai mana yang aman untuk menonaktifkan penghemat baterai.

API ini dapat diganti oleh pengguna dan penghemat baterai tertunda dengan cara yang sama seperti penghemat baterai otomatis berbasis persentase. Lihat dokumentasi API untuk mengetahui informasi selengkapnya.

Agar API berhasil dipanggil, setelan kueri global untuk memverifikasi bahwa setelan dukungan berubah nilai sesuai dengan panggilan API.

Misalnya, jika pengguna memilih mode penghemat baterai rutin dan aplikasi memanggil setDynamicPowerSaveHint(true, 10), setelan 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 menjadi:

automatic_power_save_mode: 1
dynamic_power_savings_disable_threshold: 25
dynamic_power_savings_enabled: 0

Anda dapat memeriksa 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 yang akan digunakan OEM untuk memutuskan kapan harus memicu mode penghemat baterai rutin. Oleh karena itu, OEM bertanggung jawab untuk menguji integrasi mereka guna memastikan perilakunya memenuhi ekspektasi. Secara khusus, pastikan perangkat dapat memenuhi tugas berikut:

  • Pengguna memilih berdasarkan persentase di UI jadwal penghemat baterai dan memilih 15%. Penghemat baterai akan aktif secara otomatis HANYA saat baterai sudah mencapai 15%.
  • Pengguna memilih berdasarkan rutinitas di UI jadwal penghemat baterai. Saat aplikasi memanggil API dengan true, penghemat baterai akan diaktifkan. Selain itu, penghemat baterai akan otomatis dinonaktifkan jika perangkat diisi dayanya ke tingkat batas yang ditunjukkan dan tidak dicolokkan.
  • Pengguna memilih none di UI jadwal penghemat baterai. Penghemat baterai TIDAK PERNAH aktif secara otomatis.
  • Jika aplikasi mengaktifkan penghemat baterai dan pengguna secara manual mengganti penghemat baterai agar dinonaktifkan lagi (menggunakan Setelan Cepat, Setelan, dll.), aplikasi akan TETAP NONAKTIF hingga pengguna mengaktifkannya kembali secara manual atau mencolokkan perangkat.