Mulai 27 Maret 2025, sebaiknya gunakan android-latest-release, bukan aosp-main, untuk mem-build dan berkontribusi pada AOSP. Untuk mengetahui informasi selengkapnya, lihat Perubahan pada AOSP.

Halaman ini diterjemahkan oleh Cloud Translation API.

Penghemat baterai rutin
Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

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 Setelan bahwa perangkat telah dikonfigurasi dengan benar, gunakan overlay konfigurasi 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, maka Anda akan 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, bangun gambar, flash ke ponsel, dan navigasikan ke Settings > Baterai > Aki Penghemat > Jadwal Penghemat Baterai. Opsi berdasarkan rutinitas akan muncul.

Batas nonaktif default

Kolom config_dynamicPowerSavingsDefaultDisableThreshold baru menentukan level baterai saat sistem menonaktifkan penghemat baterai, jika sedang aktif oleh penjadwal berdasarkan rutinitas. Default sistem adalah 80%, tetapi Anda bisa mengubahnya.

Konfigurasi aplikasi

Izin

API yang diperlukan aplikasi untuk mengaktifkan penghemat baterai dari aplikasi dilindungi dengan izin android.permission.POWER_SAVER. Ini adalah izin tanda tangan/istimewa, jadi berikan izin ini ke aplikasi yang ingin Anda gunakan untuk memicu penghemat baterai 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 terlebih dahulu ke versi aplikasi di sistem aplikasi tidak bisa memperoleh izin atau memanggil API dengan benar. Tujuan sistem tidak memberikan umpan balik di luar kesalahan izin biasanya, jadi memverifikasi bahwa 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. Berikan POWER_SAVER aplikasi hanya untuk satu aplikasi dan mengizinkannya 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 seharusnya 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 aktif. 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 penundaan penghemat baterai dengan cara yang sama seperti penghemat baterai otomatis berbasis persentase. Lihat Dokumentasi API untuk informasi selengkapnya.

Untuk memverifikasi bahwa API berhasil dipanggil, kueri setelan global untuk memverifikasi nilai setelan pencadangan berubah 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:

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 menguji integrasi mereka untuk memastikan bahwa perilakunya memenuhi harapan. Secara khusus, verifikasi bahwa 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 mencapai 15% baterai.
Pengguna memilih berdasarkan rutinitas di UI jadwal penghemat baterai. Kapan aplikasi memanggil API dengan true, penghemat baterai diaktifkan. Selain itu, penghemat baterai akan otomatis nonaktif jika perangkat diisi daya menunjukkan tingkat ambang batas dan tidak terhubung.
Pengguna memilih none di UI jadwal penghemat baterai. Penghemat baterai TIDAK BOLEH aktif secara otomatis.
Jika aplikasi mengaktifkan penghemat baterai dan pengguna mengganti baterai secara manual saver dinonaktifkan lagi (menggunakan Setelan Cepat, Setelan, dll.), seharusnya TETAP NONAKTIF hingga pengguna mengaktifkannya kembali secara manual atau mencolokkan perangkat.