Penguncian layar saat aktif parsial yang berlebihan

Penguncian layar saat aktif parsial adalah mekanisme di PowerManager API yang memungkinkan developer menjaga CPU tetap berjalan setelah layar perangkat dinonaktifkan (terlepas dari akibat waktu tunggu sistem atau pengguna menekan tombol daya). Aplikasi Anda melakukan penguncian layar saat aktif parsial dengan memanggil acquire() dengan tanda PARTIAL_WAKE_LOCK, atau dengan menggunakan API lain yang melakukan penguncian layar saat aktif. Penggunaan penguncian layar saat aktif sebagian 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 Anda 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 berikan masukan Anda kepada kami 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 2 jam atau lebih dalam periode 24 jam. Android vitals melacak durasi penguncian layar hanya jika penguncian layar dipertahankan saat aplikasi berada di latar belakang atau menjalankan layanan latar depan. Saat ini, Android vitals mengecualikan kunci tetap aktif yang dibuat oleh API yang dimulai pengguna audio, lokasi, dan JobScheduler dari perhitungan kunci tetap aktif.

Dasbor penguncian layar saat aktif parsial berlebihan Android vitals memberikan perincian nama penguncian layar saat aktif yang tidak dikecualikan dan terkait dengan aplikasi Anda, yang menunjukkan sesi dan durasi yang terpengaruh.

Jika kunci aktif 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 tersebut 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 menguras baterai perangkat, Anda tidak boleh menggunakan penguncian layar saat aktif jika ada alternatif lain. Dokumentasi Memilih API yang tepat untuk menjaga 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 merusak efisiensi perangkat. Khususnya, pastikan setiap perangkat yang Anda peroleh dilepaskan, dan lepaskan kunci secepat mungkin.

Aplikasi Anda mungkin juga menggunakan penguncian layar saat aktif meskipun Anda tidak mendapatkan penguncian layar saat aktif secara eksplisit. Jika Anda melihat kunci aktif yang dikaitkan dengan aplikasi yang tidak Anda kenali, mengidentifikasi kunci aktif yang dibuat oleh API lain dapat membantu Anda mengidentifikasi API yang mungkin telah membuatnya.

Setelah memperbaiki masalah di kode, Anda dapat memverifikasi perbaikan dengan menggunakan alat debug penguncian layar saat aktif lokal.

Lihat juga