Penguncian layar saat aktif parsial yang berlebihan (beta)

Penguncian layar saat aktif parsial adalah mekanisme di PowerManager API yang memungkinkan developer menjaga CPU tetap berjalan setelah layar perangkat dinonaktifkan (baik karena waktu tunggu sistem habis atau pengguna menekan tombol daya). Aplikasi Anda memperoleh penguncian layar saat aktif parsial dengan memanggil acquire() dengan flag PARTIAL_WAKE_LOCK, atau dengan menggunakan API lain yang memperoleh kunci layar saat aktif. Penggunaan penguncian layar saat aktif parsial yang berlebihan akan menghabiskan baterai perangkat karena mencegah perangkat memasuki status daya yang lebih rendah. Penguncian layar saat aktif parsial sebaiknya hanya digunakan saat diperlukan dan dilepaskan segera setelah tidak diperlukan lagi.

Jika aplikasi menggunakan penguncian layar saat aktif parsial secara berlebihan, Anda dapat menggunakan panduan di halaman ini untuk mendiagnosis dan memperbaiki masalahnya.

Masukan Anda adalah bagian penting untuk meningkatkan kualitas dokumentasi kami. Harap beri kami masukan menggunakan link berikut:

Beri masukan

Mendeteksi masalah

Android vitals dapat membantu Anda mengetahui kapan penggunaan penguncian layar saat aktif parsial aplikasi Anda berlebihan.

Android vitals

Android vitals dapat membantu meningkatkan performa aplikasi dengan memberi tahu Anda melalui Konsol Play jika penggunaan penguncian layar saat aktif parsial oleh aplikasi Anda berlebihan.

Android vitals melaporkan penggunaan penguncian layar saat aktif parsial sebagai berlebihan jika semua penguncian layar saat aktif parsial, jika dijumlahkan, berjalan selama 3 jam atau lebih dalam periode 24 jam.

Android vitals melacak waktu hanya jika penguncian layar saat aktif ditahan saat aplikasi berada di latar belakang dan tidak memiliki layanan latar depan.

Android vitals memberikan beberapa pengecualian untuk penggunaan penguncian layar saat aktif parsial dalam skenario saat ada manfaat pengguna yang jelas dari penguncian layar saat aktif parsial, dan tidak ada cara yang lebih baik untuk mencapai hasil tersebut tanpa penguncian layar saat aktif parsial. Dalam kasus tersebut, Android vitals mungkin tidak menghitung waktu penguncian layar saat aktif parsial terhadap batas 3 jam. Misalnya, jika aplikasi memutar audio untuk pengguna, ada manfaat yang jelas untuk menjaga perangkat tetap aktif dan tidak ada cara untuk memutar audio tanpa menjaga perangkat tetap aktif. Dalam hal ini, waktu penguncian layar saat aktif parsial tidak dihitung terhadap Android vitals.

Jika kunci layar sebagian yang berlebihan terjadi di lebih dari 5% sesi aplikasi di semua perangkat dalam periode 28 hari, hal ini dapat memengaruhi visibilitas aplikasi Anda di Play setelah metrik keluar dari versi beta.

Setelah Anda mengetahui bahwa aplikasi memiliki penguncian layar saat aktif parsial yang berlebihan, langkah berikutnya adalah mengatasi masalah.

Memperbaiki masalah

Karena penguncian layar saat aktif dapat menghabiskan baterai perangkat, Anda tidak boleh menggunakan penguncian layar saat aktif jika ada alternatif. Dokumentasi Memilih API yang tepat untuk membuat perangkat tetap aktif dapat membantu Anda menemukan solusi terbaik untuk aplikasi Anda.

Jika Anda perlu menggunakan penguncian layar saat aktif, ikuti praktik terbaik penguncian layar saat aktif untuk memastikan penguncian layar saat aktif tidak mengganggu efisiensi perangkat. Secara khusus, pastikan setiap perangkat yang Anda peroleh dirilis, dan lepaskan kunci secepat mungkin.

Setelah memperbaiki masalah dalam kode, Anda dapat memverifikasi perbaikan menggunakan alat proses debug kunci layar saat aktif lokal.

Lihat juga