Batasan dalam memulai layanan latar depan dari latar belakang

Aplikasi yang menargetkan Android 12 (API level 31) atau yang lebih tinggi tidak dapat memulai layanan latar depan saat aplikasi berjalan di latar belakang, kecuali untuk beberapa kasus khusus. Jika aplikasi mencoba memulai layanan latar depan saat aplikasi berjalan di latar belakang, dan layanan latar depan tersebut bukan merupakan kasus khusus, sistem akan menampilkan ForegroundServiceStartNotAllowedException.

Selain itu, jika aplikasi ingin meluncurkan layanan latar depan yang memerlukan izin saat penggunaan (misalnya, izin sensor tubuh, kamera, mikrofon, atau lokasi), aplikasi tidak dapat membuat layanan saat aplikasi berada di latar belakang, meskipun aplikasi termasuk dalam salah satu pengecualian dari batasan peluncuran latar belakang. Alasannya dijelaskan di bagian Batasan untuk memulai layanan latar depan yang memerlukan izin saat penggunaan

Pengecualian dari batasan peluncuran latar belakang

Dalam situasi berikut, aplikasi Anda dapat memulai layanan latar depan bahkan saat aplikasi berjalan di latar belakang:

Aplikasi Anda bertransisi dari status yang terlihat oleh pengguna, seperti an aktivitas.
Aplikasi Anda dapat memulai aktivitas dari latar belakang, kecuali jika aplikasi memiliki aktivitas di data sebelumnya pada tugas yang ada.
Aplikasi Anda menerima pesan prioritas tinggi menggunakan Firebase Cloud Messaging.

Catatan: Sistem dapat menurunkan prioritas pesan prioritas tinggi ke prioritas normal jika aplikasi tidak menggunakan pesan prioritas tinggi untuk menampilkan konten yang sensitif terhadap waktu kepada pengguna. Jika prioritas pesan diturunkan, aplikasi Anda tidak dapat memulai layanan latar depan dan mencoba memulai satu akan menghasilkan ForegroundServiceStartNotAllowedException.

Jadi, sebaiknya periksa hasil RemoteMessage.getPriority() dan pastikan hasilnya PRIORITY_HIGH() sebelum mencoba memulai layanan latar depan. Untuk panduan tentang pesan prioritas tinggi dan kapan menggunakannya, lihat FCM's documentation.
Pengguna menjalankan tindakan di elemen UI yang terkait dengan aplikasi Anda. Misalnya, pengguna mungkin berinteraksi dengan balon, notifikasi, widget, atau aktivitas.
Aplikasi Anda memanggil alarm yang tepat untuk menyelesaikan tindakan yang diminta pengguna.
Aplikasi Anda adalah metode input saat ini di perangkat.
Aplikasi Anda menerima peristiwa yang terkait dengan pembatasan wilayah atau transisi pengenalan aktivitas.
Setelah perangkat dimulai ulang dan menerima tindakan intent ACTION_BOOT_COMPLETED, ACTION_LOCKED_BOOT_COMPLETED, atau ACTION_MY_PACKAGE_REPLACED di penerima siaran.

Catatan: Jika aplikasi Anda menargetkan Android 14 atau yang lebih tinggi, ada batasan untuk meluncurkan jenis layanan latar depan tertentu dari BOOT_COMPLETED penerima. Untuk mengetahui informasi selengkapnya, lihat Batasan pada BOOT_COMPLETED penerima siaran yang meluncurkan layanan latar depan layanan.
Aplikasi Anda menerima tindakan intent ACTION_TIMEZONE_CHANGED, ACTION_TIME_CHANGED, atau ACTION_LOCALE_CHANGED di penerima siaran.
Aplikasi Anda menerima peristiwa ACTION_TRANSACTION_DETECTED dari NfcService.
Aplikasi dengan peran atau izin sistem tertentu, seperti pemilik perangkat dan pemilik profil.
Aplikasi Anda menggunakan Pengelola Perangkat Pendamping dan mendeklarasikan REQUEST_COMPANION_START_FOREGROUND_SERVICES_FROM_BACKGROUND izin atau REQUEST_COMPANION_RUN_IN_BACKGROUND izin. Jika memungkinkan, gunakan REQUEST_COMPANION_START_FOREGROUND_SERVICES_FROM_BACKGROUND.
Pengguna menonaktifkan pengoptimalan baterai untuk aplikasi Anda.
Aplikasi Anda memiliki izin SYSTEM_ALERT_WINDOW. Catatan: Jika aplikasi Anda menargetkan Android 15 atau yang lebih tinggi, aplikasi harus memiliki izin SYSTEM_ALERT_WINDOW dan aplikasi harus memiliki jendela overlay yang terlihat saat ini.

Batasan untuk memulai layanan latar depan yang memerlukan izin saat penggunaan

Di Android 14 (API level 34) atau yang lebih tinggi, ada situasi khusus yang perlu diperhatikan jika Anda memulai layanan latar depan yang memerlukan izin saat penggunaan.

Jika aplikasi Anda menargetkan Android 14 atau yang lebih tinggi, sistem operasi akan memeriksa saat Anda membuat layanan latar depan untuk memastikan aplikasi Anda memiliki semua izin yang sesuai untuk jenis layanan tersebut. Misalnya, saat Anda membuat layanan latar depan jenis mikrofon, sistem operasi akan memverifikasi bahwa aplikasi Anda saat ini memiliki izin RECORD_AUDIO. Jika Anda tidak memiliki izin tersebut, sistem akan menampilkan SecurityException.

Untuk izin saat penggunaan, hal ini menyebabkan potensi masalah. Jika aplikasi Anda memiliki izin saat penggunaan, aplikasi hanya memiliki izin tersebut saat berada di latar depan. Artinya, jika aplikasi Anda berada di latar belakang, dan mencoba membuat layanan latar depan jenis kamera, lokasi, atau mikrofon, sistem akan melihat bahwa aplikasi Anda saat ini tidak memiliki izin yang diperlukan, dan sistem akan menampilkan SecurityException.

Demikian pula, jika aplikasi Anda berada di latar belakang dan membuat layanan kesehatan yang memerlukan izin BODY_SENSORS, aplikasi saat ini tidak memiliki izin tersebut, dan sistem akan menampilkan pengecualian. (Hal ini tidak berlaku jika layanan kesehatan memerlukan izin yang berbeda, seperti ACTIVITY_RECOGNITION.) Memanggil PermissionChecker.checkSelfPermission() tidak mencegah masalah ini. Jika aplikasi Anda memiliki izin saat penggunaan, dan memanggil checkSelfPermission() untuk memeriksa apakah aplikasi memiliki izin tersebut, metode ini akan menampilkan PERMISSION_GRANTED meskipun aplikasi berada di latar belakang. Saat metode menampilkan PERMISSION_GRANTED, metode tersebut mengatakan "aplikasi Anda memiliki izin ini saat aplikasi digunakan".

Oleh karena itu, jika layanan latar depan Anda memerlukan izin saat penggunaan, Anda harus memanggil Context.startForegroundService() atau Context.bindService() saat aplikasi Anda memiliki aktivitas yang terlihat, kecuali jika layanan termasuk dalam salah satu pengecualian yang ditentukan.

Pengecualian dari batasan izin saat penggunaan

Dalam beberapa situasi, meskipun layanan latar depan dimulai saat aplikasi berjalan di latar belakang, layanan tersebut masih dapat mengakses informasi lokasi, kamera, dan mikrofon saat aplikasi berjalan di latar depan ("saat penggunaan").

Dalam situasi yang sama, jika layanan mendeklarasikan layanan latar depan jenis dari location dan dimulai oleh aplikasi yang memiliki izin ACCESS_BACKGROUND_LOCATION, layanan ini dapat mengakses informasi lokasi sepanjang waktu, bahkan saat aplikasi berjalan di latar belakang.

Daftar berikut berisi situasi ini:

Komponen sistem memulai layanan.
Layanan dimulai dengan berinteraksi dengan widget aplikasi.
Layanan dimulai dengan berinteraksi dengan notifikasi.
Layanan dimulai sebagai PendingIntent yang dikirim dari aplikasi lain yang terlihat.
Layanan dimulai oleh aplikasi yang merupakan pengontrol kebijakan perangkat yang berjalan dalam mode pemilik perangkat.
Layanan dimulai oleh aplikasi yang menyediakan VoiceInteractionService.
Layanan dimulai oleh aplikasi yang memiliki izin hak istimewa START_ACTIVITIES_FROM_BACKGROUND.

Menentukan layanan yang terpengaruh di aplikasi Anda

Saat menguji aplikasi Anda, mulai layanan latar depannya. Jika layanan yang dimulai memiliki akses terbatas ke lokasi, mikrofon, dan kamera, pesan berikut akan muncul di Logcat:

Foreground service started from background can not have \
location/camera/microphone access: service SERVICE_NAME