Layanan latar depan

Layanan latar depan melakukan operasi yang dapat dilihat oleh pengguna.

Layanan latar depan menampilkan notifikasi status bar, agar pengguna tahu bahwa aplikasi Anda sedang menjalankan tugas di latar depan dan memakai resource sistem.

Contoh aplikasi yang menggunakan layanan latar depan meliputi:

• Aplikasi pemutar musik yang memutar musik di layanan latar depan. Notifikasi mungkin menunjukkan lagu yang sedang diputar.
• Aplikasi kebugaran yang merekam aktivitas lari pengguna di layanan latar depan, setelah menerima izin dari pengguna. Notifikasi mungkin menampilkan jarak yang telah ditempuh pengguna selama sesi kebugaran saat ini.

Hanya gunakan layanan latar depan saat aplikasi Anda perlu melakukan tugas yang terlihat oleh pengguna, meskipun saat pengguna tidak berinteraksi langsung dengan aplikasi. Jika tindakan tersebut cukup rendah sehingga Anda ingin menggunakan notifikasi prioritas minimum, buat tugas latar belakang.

Catatan: Untuk banyak kasus penggunaan, ada platform yang dibuat khusus atau Jetpack API yang dapat Anda gunakan untuk melakukan pekerjaan, bukan layanan latar depan. Jika ada API seperti itu, hampir selalu lebih baik menggunakannya daripada layanan latar depan. Untuk mengetahui informasi selengkapnya, lihat Menggunakan API yang dibuat khusus, bukan layanan latar depan.

Dokumen ini menjelaskan izin yang diperlukan untuk menggunakan layanan latar depan, serta cara memulai layanan latar depan dan menghapusnya dari latar belakang. Bagian ini juga menjelaskan cara mengaitkan kasus penggunaan tertentu dengan jenis layanan latar depan, dan pembatasan akses yang berlaku saat Anda memulai layanan latar depan dari aplikasi yang berjalan di latar belakang.

Pengguna dapat menutup notifikasi secara default

Mulai Android 13 (API level 33), pengguna dapat menutup notifikasi yang terkait dengan layanan latar depan secara default. Untuk melakukannya, pengguna melakukan gestur geser pada notifikasi. Secara tradisional, notifikasi tidak akan ditutup kecuali jika layanan latar depan dihentikan atau dihapus dari latar depan.

Jika Anda ingin notifikasi tidak dapat ditutup oleh pengguna, teruskan true ke metode setOngoing() saat Anda membuat notifikasi menggunakan Notification.Builder.

Catatan: Perangkat yang menjalankan Android 12 (API level 31) atau yang lebih baru memberikan pengalaman yang sederhana untuk layanan latar depan jangka pendek. Pada perangkat ini, sistem akan menunggu 10 detik sebelum menampilkan notifikasi yang terkait dengan layanan latar depan. Ada beberapa pengecualian karena beberapa jenis layanan selalu langsung menampilkan notifikasi.

Layanan yang langsung menampilkan notifikasi

Jika layanan latar depan memiliki setidaknya salah satu karakteristik berikut, sistem akan segera menampilkan notifikasi terkait setelah layanan dimulai, bahkan pada perangkat yang menjalankan Android 12 atau yang lebih tinggi:

• Layanan ini dikaitkan dengan notifikasi yang menyertakan tombol tindakan.
• Layanan memiliki foregroundServiceType dari mediaPlayback, mediaProjection, atau phoneCall.
• Layanan ini menyediakan kasus penggunaan yang berkaitan dengan panggilan telepon, navigasi, atau pemutaran media, seperti yang dijelaskan dalam atribut kategori notifikasi.
• Layanan memilih tidak menggunakan perubahan perilaku dengan meneruskan FOREGROUND_SERVICE_IMMEDIATE ke setForegroundServiceBehavior() saat menyiapkan notifikasi.

Di Android 13 (API level 33) atau yang lebih tinggi, jika pengguna menolak izin notifikasi, mereka masih akan melihat pemberitahuan terkait layanan latar depan di Task Manager, tetapi tidak melihatnya di panel samping notifikasi.

Mendeklarasikan layanan latar depan dalam manifes Anda

Dalam manifes aplikasi, deklarasikan setiap layanan latar depan aplikasi Anda dengan elemen <service>. Untuk setiap layanan, gunakan atribut android:foregroundServiceType untuk mendeklarasikan jenis pekerjaan yang dilakukan layanan tersebut.

Misalnya, jika aplikasi Anda membuat layanan latar depan yang memutar musik, Anda dapat mendeklarasikan layanan seperti ini:

<manifest xmlns:android="http://schemas.android.com/apk/res/android" ...>

    <service
        android:name=".MyMediaPlaybackService"
        android:foregroundServiceType="mediaPlayback"
        android:exported="false">
    </service>
</manifest>

Jika beberapa jenis Anda berlaku untuk layanan Anda, pisahkan dengan operator |. Misalnya, layanan yang menggunakan kamera dan mikrofon akan mendeklarasikannya seperti ini:

android:foregroundServiceType="camera|microphone"

Catatan: Bergantung pada API level yang ditargetkan aplikasi, Anda mungkin diwajibkan untuk menyatakan layanan latar depan dalam manifes aplikasi:

• API level 29 atau yang lebih tinggi: Anda harus mendeklarasikan semua layanan latar depan yang menggunakan informasi lokasi, menggunakan jenis layanan location.
• API level 30 atau lebih tinggi: Anda harus mendeklarasikan semua layanan latar depan yang menggunakan kamera atau mikrofon, masing-masing menggunakan jenis layanan camera atau microphone.
• API level 34 atau yang lebih tinggi: Anda harus mendeklarasikan semua layanan latar depan beserta jenis layanannya.

Jika Anda mencoba membuat layanan latar depan dan jenisnya tidak dideklarasikan dalam manifes, sistem akan menampilkan MissingForegroundServiceTypeException setelah memanggil startForeground().

Meskipun tidak diwajibkan, praktik terbaiknya adalah untuk menyatakan semua layanan latar depan Anda dan menyediakan jenis layanannya.

Meminta izin layanan latar depan

Aplikasi yang menargetkan Android 9 (API level 28) atau yang lebih tinggi dan menggunakan layanan latar depan perlu meminta FOREGROUND_SERVICE dalam manifes aplikasi, seperti yang ditampilkan dalam cuplikan kode berikut. Ini adalah izin normal, sehingga sistem akan otomatis memberikannya ke aplikasi yang meminta.

Selain itu, jika menargetkan API level 34 atau yang lebih tinggi, aplikasi harus meminta jenis izin yang sesuai untuk jenis pekerjaan yang akan dilakukan oleh layanan latar depan. Setiap jenis layanan latar depan memiliki jenis izin yang sesuai. Misalnya, jika aplikasi meluncurkan layanan latar depan yang menggunakan kamera, Anda harus meminta izin FOREGROUND_SERVICE dan FOREGROUND_SERVICE_CAMERA. Semua ini adalah izin normal, jadi sistem akan memberikannya secara otomatis jika tercantum dalam manifes.

<manifest xmlns:android="http://schemas.android.com/apk/res/android" ...>

    <uses-permission android:name="android.permission.FOREGROUND_SERVICE"/>
    <uses-permission android:name="android.permission.FOREGROUND_SERVICE_CAMERA"/>

    <application ...>
        ...
    </application>
</manifest>

Catatan: Jika aplikasi yang menargetkan API level 28 atau yang lebih tinggi mencoba membuat layanan latar depan tanpa meminta izin FOREGROUND_SERVICE, sistem akan menampilkan SecurityException. Demikian pula, jika aplikasi menargetkan API level 34 atau yang lebih tinggi dan tidak meminta izin khusus yang sesuai, sistem akan menampilkan SecurityException.

Prasyarat layanan latar depan

Mulai Android 14 (API level 34), saat Anda meluncurkan layanan latar depan, sistem akan memeriksa prasyarat tertentu berdasarkan jenis layanan. Misalnya, jika Anda mencoba meluncurkan layanan latar depan jenis location, sistem akan memeriksa untuk memastikan aplikasi Anda sudah memiliki izin ACCESS_COARSE_LOCATION atau ACCESS_FINE_LOCATION. Jika tidak, sistem akan menampilkan SecurityException.

Karena alasan ini, Anda harus mengonfirmasi bahwa prasyarat yang diperlukan terpenuhi sebelum memulai layanan latar depan. Dokumentasi jenis layanan latar depan mencantumkan prasyarat yang diperlukan untuk setiap jenis layanan latar depan.

Memulai layanan latar depan

Sebelum Anda meminta sistem untuk menjalankan layanan sebagai layanan latar depan, mulai layanan itu sendiri:

Kotlin

val intent = Intent(...) // Build the intent for the service
context.startForegroundService(intent)

Java

Context context = getApplicationContext();
Intent intent = new Intent(...); // Build the intent for the service
context.startForegroundService(intent);

Di dalam layanan, biasanya dalam onStartCommand(), Anda dapat meminta agar layanan berjalan di latar depan. Untuk melakukannya, panggil ServiceCompat.startForeground() (tersedia di androidx-core 1.12 dan yang lebih baru). Metode ini menggunakan parameter berikut:

• Layanan
• Bilangan bulat positif yang mengidentifikasi notifikasi di status bar secara unik
• Objek Notification itu sendiri
• Jenis layanan latar depan yang mengidentifikasi pekerjaan yang dilakukan oleh layanan

Jenis ini mungkin merupakan subset dari jenis yang dideklarasikan dalam manifes, bergantung pada kasus penggunaan tertentu. Kemudian, jika perlu menambahkan jenis layanan lainnya, Anda dapat memanggil startForeground() lagi.

Catatan: Jika Anda meneruskan jenis layanan latar depan ke startForeground yang tidak Anda deklarasikan dalam manifes, sistem akan menampilkan IllegalArgumentException.

Misalnya, aplikasi kebugaran menjalankan layanan pemantau lari yang selalu memerlukan informasi location, tetapi mungkin perlu atau tidak perlu memutar media. Anda harus mendeklarasikan location dan mediaPlayback dalam manifes. Jika pengguna mulai berlari dan hanya ingin melacak lokasinya, aplikasi Anda harus memanggil startForeground() dan meneruskan izin ACCESS_FINE_LOCATION saja. Kemudian, jika pengguna ingin mulai memutar audio, panggil startForeground() lagi dan teruskan kombinasi bitwise dari semua jenis layanan latar depan (dalam hal ini, ACCESS_FINE_LOCATION|FOREGROUND_SERVICE_MEDIA_PLAYBACK).

Catatan: Notifikasi status bar harus menggunakan prioritas PRIORITY_LOW atau yang lebih tinggi. Jika aplikasi Anda mencoba menggunakan notifikasi yang memiliki prioritas lebih rendah, sistem akan menambahkan pesan ke panel samping notifikasi sehingga memberi tahu pengguna tentang penggunaan layanan latar depan oleh aplikasi.

Berikut adalah contoh yang meluncurkan layanan latar depan kamera:

Kotlin

class MyCameraService: Service() {

  private fun startForeground() {
    // Before starting the service as foreground check that the app has the
    // appropriate runtime permissions. In this case, verify that the user has
    // granted the CAMERA permission.
    val cameraPermission =
            ContextCompat.checkSelfPermission(this, Manifest.permission.CAMERA)
    if (cameraPermission == PackageManager.PERMISSION_DENIED) {
        // Without camera permissions the service cannot run in the foreground
        // Consider informing user or updating your app UI if visible.
        stopSelf()
        return
    }

    try {
        val notification = NotificationCompat.Builder(this, "CHANNEL_ID")
            // Create the notification to display while the service is running
            .build()
        ServiceCompat.startForeground(
            /* service = */ this,
            /* id = */ 100, // Cannot be 0
            /* notification = */ notification,
            /* foregroundServiceType = */
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
                ServiceInfo.FOREGROUND_SERVICE_TYPE_CAMERA
            } else {
                0
            },
        )
    } catch (e: Exception) {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S
                && e is ForegroundServiceStartNotAllowedException) {
            // App not in a valid state to start foreground service
            // (e.g. started from bg)
        }
        // ...
    }
  }
}

Java

public class MyCameraService extends Service {

    private void startForeground() {
        // Before starting the service as foreground check that the app has the
        // appropriate runtime permissions. In this case, verify that the user
        // has granted the CAMERA permission.
        int cameraPermission =
            ContextCompat.checkSelfPermission(this, Manifest.permission.CAMERA);
        if (cameraPermission == PackageManager.PERMISSION_DENIED) {
            // Without camera permissions the service cannot run in the
            // foreground. Consider informing user or updating your app UI if
            // visible.
            stopSelf();
            return;
        }

        try {
            Notification notification =
                new NotificationCompat.Builder(this, "CHANNEL_ID")
                    // Create the notification to display while the service
                    // is running
                    .build();
            int type = 0;
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
                type = ServiceInfo.FOREGROUND_SERVICE_TYPE_CAMERA;
            }
            ServiceCompat.startForeground(
                    /* service = */ this,
                    /* id = */ 100, // Cannot be 0
                    /* notification = */ notification,
                    /* foregroundServiceType = */ type
            );
        } catch (Exception e) {
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S &&
                    e instanceof ForegroundServiceStartNotAllowedException
            ) {
                // App not in a valid state to start foreground service
                // (e.g started from bg)
            }
            // ...
        }
    }

    //...
}

Menghapus layanan dari latar depan

Untuk menghapus layanan dari latar depan, panggil stopForeground(). Metode ini memerlukan boolean, yang menunjukkan apakah notifikasi status bar juga akan dihapus. Perhatikan bahwa layanan akan terus berjalan.

Jika Anda menghentikan layanan saat berjalan di latar depan, notifikasinya akan dihapus.

Menangani penghentian aplikasi yang dimulai oleh pengguna yang menjalankan layanan latar depan

Gambar 1. Alur kerja Pengelola Tugas di perangkat yang menjalankan Android 13 atau yang lebih baru.

Mulai Android 13 (API level 33), pengguna dapat menyelesaikan alur kerja dari panel samping notifikasi untuk menghentikan aplikasi yang memiliki layanan latar depan yang sedang berlangsung, terlepas dari versi SDK target aplikasi tersebut. Kemampuan ini, yang disebut Task Manager, menampilkan daftar aplikasi yang saat ini menjalankan layanan latar depan.

Daftar ini diberi label Aplikasi aktif. Di samping setiap aplikasi terdapat tombol Berhenti. Gambar 1 mengilustrasikan alur kerja Pengelola Tugas pada perangkat yang menjalankan Android 13.

Ketika pengguna menekan tombol Stop di samping aplikasi Anda di Pengelola Tugas, tindakan berikut akan terjadi:

• Sistem menghapus aplikasi Anda dari memori. Oleh karena itu, seluruh aplikasi akan berhenti, bukan hanya layanan latar depan yang berjalan.
• Sistem menghapus data sebelumnya dari aktivitas aplikasi Anda.
• Pemutaran media apa pun akan berhenti.
• Notifikasi yang terkait dengan layanan latar depan dihapus.
• Aplikasi Anda tetap ada dalam histori.
• Tugas terjadwal dijalankan pada waktu yang dijadwalkan.
• Alarm akan berbunyi pada waktu atau jangka waktu yang dijadwalkan.

Catatan: Sistem tidak akan mengirimkan callback ke aplikasi Anda saat pengguna mengetuk tombol Stop. Saat aplikasi dimulai kembali, sebaiknya periksa alasan REASON_USER_REQUESTED yang merupakan bagian dari ApplicationExitInfo API.

Untuk menguji apakah aplikasi Anda berperilaku seperti yang diharapkan saat dan setelah pengguna menghentikan aplikasi, jalankan perintah ADB berikut di jendela terminal:

adb shell cmd activity stop-app PACKAGE_NAME

Pengecualian

Sistem ini menyediakan beberapa tingkat pengecualian untuk jenis aplikasi tertentu, yang dijelaskan di bagian berikut.

Pengecualian berlaku per aplikasi, bukan per proses. Jika sistem mengecualikan satu proses dalam sebuah aplikasi, semua proses lain dalam aplikasi tersebut juga akan dikecualikan.

Catatan: Beberapa aplikasi bawaan yang dikonfigurasi oleh produsen mungkin juga dikecualikan.

Pengecualian agar tidak muncul sama sekali di Pengelola Tugas

Aplikasi berikut dapat menjalankan layanan latar depan dan tidak muncul sama sekali di Task Manager:

• Aplikasi tingkat sistem
• Aplikasi keselamatan; yaitu, aplikasi yang memiliki peran ROLE_EMERGENCY
• Perangkat yang menggunakan mode demo

Pengecualian agar tidak dapat dihentikan oleh pengguna

Saat jenis aplikasi berikut menjalankan layanan latar depan, aplikasi tersebut akan muncul di Pengelola Tugas, tetapi tidak ada tombol Stop di samping nama aplikasi yang dapat diketuk oleh pengguna:

• Aplikasi Pemilik perangkat
• Aplikasi Pemilik profil
• Aplikasi persisten
• Aplikasi yang memiliki peran ROLE_DIALER

Menggunakan API yang dibuat khusus, bukan layanan latar depan

Untuk banyak kasus penggunaan, ada platform atau Jetpack API yang dapat digunakan untuk melakukan pekerjaan yang mungkin Anda gunakan untuk layanan latar depan. Jika ada API buatan yang sesuai, hampir selalu Anda harus menggunakannya, bukan menggunakan layanan latar depan. API yang dibuat khusus sering kali menyediakan kemampuan khusus kasus penggunaan tambahan yang harus Anda bangun sendiri. Misalnya, Bubbles API menangani logika UI yang kompleks untuk aplikasi pesan yang perlu mengimplementasikan fitur balon chat.

Dokumentasi untuk jenis layanan latar depan mencantumkan alternatif yang baik untuk digunakan, bukan layanan latar depan.

Batasan dalam memulai layanan latar depan dari latar belakang

Aplikasi yang menargetkan Android 12 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 tidak memenuhi salah satu kasus luar biasa, sistem akan menampilkan ForegroundServiceStartNotAllowedException.

Catatan: Jika satu aplikasi memanggil Context.startForegroundService() untuk memulai layanan latar depan yang dimiliki aplikasi lain, pembatasan ini hanya berlaku jika kedua aplikasi menargetkan Android 12 atau yang lebih tinggi.

Selain itu, jika aplikasi ingin meluncurkan layanan latar depan yang memerlukan izin saat digunakan (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 pembatasan mulai latar belakang. Alasannya dijelaskan di bagian Pembatasan saat memulai layanan latar depan yang memerlukan izin saat digunakan.

Pengecualian dari pembatasan memulai 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 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 berprioritas tinggi menggunakan Firebase Cloud Messaging.

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

  Jadi, sebaiknya periksa hasil RemoteMessage.getPriority() dan mengonfirmasi bahwa PRIORITY_HIGH() sebelum mencoba memulai layanan latar depan. Untuk panduan tentang pesan berprioritas 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 perangkat saat ini.

• 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.

• Aplikasi Anda menerima tindakan intent ACTION_TIMEZONE_CHANGED, ACTION_TIME_CHANGED, atau ACTION_LOCALE_CHANGED di penerima siaran.

• Aplikasi dengan peran atau izin sistem tertentu, seperti pemilik perangkat dan pemilik profil.

• Aplikasi Anda menggunakan Pengelola Perangkat Pendamping dan mendeklarasikan izin REQUEST_COMPANION_START_FOREGROUND_SERVICES_FROM_BACKGROUND atau izin REQUEST_COMPANION_RUN_IN_BACKGROUND. Jika memungkinkan, gunakan REQUEST_COMPANION_START_FOREGROUND_SERVICES_FROM_BACKGROUND.

• Aplikasi Anda memiliki izin SYSTEM_ALERT_WINDOW.

• Pengguna menonaktifkan pengoptimalan baterai untuk aplikasi Anda.

Batasan dalam memulai layanan latar depan yang memerlukan izin saat digunakan

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

Jika aplikasi Anda menargetkan Android 14 atau yang lebih tinggi, sistem operasi akan melakukan pemeriksaan saat Anda membuat layanan latar depan untuk memastikan aplikasi memiliki semua izin yang sesuai untuk jenis layanan tersebut. Misalnya, saat Anda membuat layanan latar depan dari 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 digunakan, hal ini dapat menimbulkan masalah. Jika aplikasi Anda memiliki izin saat digunakan, izin tersebut hanya memiliki izin tersebut saat aplikasi berada di latar depan. Artinya, jika aplikasi Anda berada di latar belakang, dan mencoba membuat layanan latar depan dari jenis kamera, lokasi, atau mikrofon, sistem akan melihat bahwa aplikasi Anda saat ini tidak memiliki izin yang diperlukan, dan akan menampilkan SecurityException.

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

Catatan: Pada versi Android yang lebih rendah dari Android 14, jika Anda mencoba membuat layanan latar depan yang memerlukan izin saat digunakan saat aplikasi berada di latar belakang, sistem akan mengizinkan Anda membuat layanan tersebut, tetapi layanan tidak akan memiliki akses ke resource yang diperlukan, dan jika layanan tersebut mencoba menggunakannya, Anda akan mendapatkan pengecualian. Di Android 14 atau yang lebih tinggi, aplikasi Anda akan mendapatkan pengecualian segera setelah mencoba membuat layanan latar depan.

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

Pengecualian dari pembatasan izin saat digunakan

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 digunakan").

Dalam situasi yang sama ini, jika layanan mendeklarasikan jenis layanan latar depan 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 berikut:

• 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