Mulai Android 14 (API level 34), Anda harus mendeklarasikan jenis layanan
yang sesuai untuk setiap layanan latar depan. Artinya, Anda harus menyatakan
jenis layanan dalam manifes aplikasi, dan juga meminta izin layanan
latar depan yang sesuai untuk jenis tersebut (selain meminta
izin
FOREGROUND_SERVICE
). Selain itu, bergantung pada jenis layanan latar depan, Anda mungkin
harus meminta izin runtime sebelum meluncurkan layanan.
Kamera
- Jenis layanan latar depan untuk dinyatakan dalam manifes di bagian
android:foregroundServiceType
camera
- Izin untuk dideklarasikan dalam manifes Anda
FOREGROUND_SERVICE_CAMERA
- Konstanta untuk diteruskan ke
startForeground()
FOREGROUND_SERVICE_TYPE_CAMERA
- Prasyarat runtime
Meminta dan diberi izin runtime
CAMERA
Catatan: Izin runtime
CAMERA
tunduk pada pembatasan saat digunakan. Karena alasan ini, Anda tidak dapat membuat layanan latar depancamera
saat aplikasi berada di latar belakang, dengan beberapa pengecualian. Untuk informasi selengkapnya, lihat Pembatasan memulai layanan latar depan yang memerlukan izin saat digunakan.- Deskripsi
Terus mengakses kamera dari latar belakang, seperti aplikasi video chat yang memungkinkan multitasking.
Perangkat yang terhubung
- Jenis layanan latar depan untuk dinyatakan dalam manifes di bawah
android:foregroundServiceType
connectedDevice
- Izin untuk dideklarasikan dalam manifes Anda
FOREGROUND_SERVICE_CONNECTED_DEVICE
- Konstanta untuk diteruskan ke
startForeground()
FOREGROUND_SERVICE_TYPE_CONNECTED_DEVICE
- Prasyarat runtime
Setidaknya salah satu syarat berikut harus terpenuhi:
Deklarasikan minimal satu izin berikut dalam manifes:
Minta dan diberi setidaknya salah satu izin runtime berikut:
Panggil
UsbManager.requestPermission()
- Deskripsi
Interaksi dengan perangkat eksternal yang memerlukan Bluetooth, NFC, IR, USB, atau koneksi jaringan.
- Alternatif
Jika aplikasi Anda perlu melakukan transfer data secara terus-menerus ke perangkat eksternal, sebaiknya gunakan pengelola perangkat pendamping. Gunakan API kehadiran perangkat pendamping untuk membantu aplikasi Anda tetap berjalan saat perangkat pendamping berada dalam jangkauan.
Jika aplikasi Anda perlu memindai perangkat Bluetooth, pertimbangkan untuk menggunakan Bluetooth Scan API.
Sinkronisasi data
- Foreground service type to declare in manifest under
android:foregroundServiceType
dataSync
- Permission to declare in your manifest
FOREGROUND_SERVICE_DATA_SYNC
- Constant to pass to
startForeground()
FOREGROUND_SERVICE_TYPE_DATA_SYNC
- Runtime prerequisites
- None
- Description
Data transfer operations, such as the following:
- Data upload or download
- Backup-and-restore operations
- Import or export operations
- Fetch data
- Local file processing
- Transfer data between a device and the cloud over a network
- Alternatives
See Alternatives to data sync foreground services for detailed information.
Kesehatan
- Foreground service type to declare in manifest under
android:foregroundServiceType
health
- Permission to declare in your manifest
FOREGROUND_SERVICE_HEALTH
- Constant to pass to
startForeground()
FOREGROUND_SERVICE_TYPE_HEALTH
- Runtime prerequisites
At least one of the following conditions must be true:
Declare the
HIGH_SAMPLING_RATE_SENSORS
permission in your manifest.Request and be granted at least one of the following runtime permissions:
Note: The
BODY_SENSORS
runtime permission is subject to while-in-use restrictions. For this reason, you cannot create ahealth
foreground service that uses body sensors while your app is in the background, with a few exceptions. For more information, see Restrictions on starting foreground services that need while-in-use permissions.- Description
Any long-running use cases to support apps in the fitness category such as exercise trackers.
Lokasi
- Foreground service type to declare in manifest under
android:foregroundServiceType
location
- Permission to declare in your manifest
FOREGROUND_SERVICE_LOCATION
- Constant to pass to
startForeground()
FOREGROUND_SERVICE_TYPE_LOCATION
- Runtime prerequisites
The user must have enabled location services and the app must be granted at least one of the following runtime permissions:
Note: In order to check that the user has enabled location services as well as granted access to the runtime permissions, use
PermissionChecker#checkSelfPermission()
Note: The location runtime permissions are subject to while-in-use restrictions. For this reason, you cannot create a
location
foreground service while your app is in the background, unless you've been granted theACCESS_BACKGROUND_LOCATION
runtime permission. For more information, see Restrictions on starting foreground services that need while-in-use permissions.- Description
Long-running use cases that require location access, such as navigation and location sharing.
- Alternatives
If your app needs to be triggered when the user reaches specific locations, consider using the geofence API instead.
Media
- Jenis layanan latar depan untuk dinyatakan dalam manifes di bawah
android:foregroundServiceType
mediaPlayback
- Izin untuk dideklarasikan dalam manifes Anda
FOREGROUND_SERVICE_MEDIA_PLAYBACK
- Konstanta untuk diteruskan ke
startForeground()
FOREGROUND_SERVICE_TYPE_MEDIA_PLAYBACK
- Prasyarat runtime
- Tidak ada
- Deskripsi
- Melanjutkan pemutaran audio atau video dari latar belakang. Mendukung fungsi Perekaman Video Digital (DVR) di Android TV.
- Alternatif
- Jika Anda menampilkan video picture-in-picture, gunakan mode Picture-in-Picture.
Proyeksi media
- Foreground service type to declare in manifest under
android:foregroundServiceType
mediaProjection
- Permission to declare in your manifest
FOREGROUND_SERVICE_MEDIA_PROJECTION
- Constant to pass to
startForeground()
FOREGROUND_SERVICE_TYPE_MEDIA_PROJECTION
- Runtime prerequisites
Call the
createScreenCaptureIntent()
method before starting the foreground service. Doing so shows a permission notification to the user; the user must grant the permission before you can create the service.After you have created the foreground service, you can call
MediaProjectionManager.getMediaProjection()
.- Description
Project content to non-primary display or external device using the
MediaProjection
APIs. This content doesn't have to be exclusively media content.- Alternatives
To stream media to another device, use the Google Cast SDK.
Mikrofon
- Jenis layanan latar depan untuk dinyatakan dalam manifes di bawah
android:foregroundServiceType
microphone
- Izin untuk dideklarasikan dalam manifes Anda
FOREGROUND_SERVICE_MICROPHONE
- Konstanta untuk diteruskan ke
startForeground()
FOREGROUND_SERVICE_TYPE_MICROPHONE
- Prasyarat runtime
Minta dan diberi izin runtime
RECORD_AUDIO
.Catatan: Izin runtime
RECORD_AUDIO
tunduk pada pembatasan saat digunakan. Karena alasan ini, Anda tidak dapat membuat layanan latar depanmicrophone
saat aplikasi berada di latar belakang, dengan beberapa pengecualian. Untuk informasi selengkapnya, lihat Pembatasan memulai layanan latar depan yang memerlukan izin saat digunakan.- Deskripsi
Melanjutkan perekaman mikrofon dari latar belakang, seperti perekam suara atau aplikasi komunikasi.
Panggilan telepon
- Jenis layanan latar depan untuk dinyatakan dalam manifes di bawah
android:foregroundServiceType
phoneCall
- Izin untuk dideklarasikan dalam manifes Anda
FOREGROUND_SERVICE_PHONE_CALL
- Konstanta untuk diteruskan ke
startForeground()
FOREGROUND_SERVICE_TYPE_PHONE_CALL
- Prasyarat runtime
Setidaknya salah satu syarat berikut harus terpenuhi:
- Aplikasi telah mendeklarasikan izin
MANAGE_OWN_CALLS
dalam file manifesnya.
- Aplikasi telah mendeklarasikan izin
- Aplikasi adalah aplikasi telepon default melalui
peran
ROLE_DIALER
.
- Aplikasi adalah aplikasi telepon default melalui
peran
- Deskripsi
Lanjutkan panggilan yang sedang berlangsung menggunakan
ConnectionService
API.- Alternatif
Jika Anda perlu melakukan panggilan telepon, video, atau VoIP, pertimbangkan untuk menggunakan library
android.telecom
.Sebaiknya gunakan
CallScreeningService
untuk menyaring panggilan.
Pengiriman pesan jarak jauh
- Foreground service type to declare in manifest under
android:foregroundServiceType
remoteMessaging
- Permission to declare in your manifest
FOREGROUND_SERVICE_REMOTE_MESSAGING
- Constant to pass to
startForeground()
FOREGROUND_SERVICE_TYPE_REMOTE_MESSAGING
- Runtime prerequisites
- None
- Description
- Transfer text messages from one device to another. Assists with continuity of a user's messaging tasks when they switch devices.
Layanan singkat
- Jenis layanan latar depan untuk dinyatakan dalam manifes di bawah
android:foregroundServiceType
shortService
- Izin untuk dideklarasikan dalam manifes Anda
- Tidak ada
- Konstanta untuk diteruskan ke
startForeground()
FOREGROUND_SERVICE_TYPE_SHORT_SERVICE
- Prasyarat runtime
- Tidak ada
- Deskripsi
Menyelesaikan pekerjaan penting dengan cepat, yang tidak dapat disela atau ditunda.
Jenis ini memiliki beberapa karakteristik unik:
- Hanya dapat dijalankan dalam waktu singkat (sekitar 3 menit).
- Tidak ada dukungan untuk layanan latar depan melekat.
- Tidak dapat memulai layanan latar depan lainnya.
- Tidak memerlukan izin khusus jenis, meskipun masih
memerlukan izin
FOREGROUND_SERVICE
. shortService
hanya dapat berubah ke jenis layanan lain jika aplikasi saat ini memenuhi syarat untuk memulai layanan latar depan baru.- Layanan latar depan dapat mengubah jenisnya menjadi
shortService
kapan saja, dan pada saat itu periode waktu tunggu akan dimulai.
Waktu tunggu untuk shortService dimulai sejak
Service.startForeground()
dipanggil. Aplikasi diharapkan memanggilService.stopSelf()
atauService.stopForeground()
sebelum waktu tunggu habis. Jika tidak,Service.onTimeout()
baru akan dipanggil dan memberi aplikasi kesempatan singkat untuk memanggilstopSelf()
ataustopForeground()
guna menghentikan layanannya.Tidak lama setelah
Service.onTimeout()
dipanggil, aplikasi akan memasuki status cache dan tidak lagi dianggap berada di latar depan, kecuali jika pengguna berinteraksi secara aktif dengan aplikasi. Tidak lama setelah aplikasi di-cache dan layanan tidak berhenti, aplikasi akan menerima ANR. Pesan ANR menyebutkanFOREGROUND_SERVICE_TYPE_SHORT_SERVICE
. Karena alasan ini, mengimplementasikan callbackService.onTimeout()
dianggap sebagai praktik terbaik.Callback
Service.onTimeout()
tidak ada di Android 13 dan yang lebih rendah. Jika layanan yang sama berjalan di perangkat tersebut, layanan tidak akan mengalami waktu tunggu, begitu juga ANR. Pastikan layanan Anda berhenti begitu selesai memproses tugas, meskipun belum menerima callbackService.onTimeout()
.Penting untuk diperhatikan bahwa jika waktu tunggu
shortService
tidak dipatuhi, aplikasi akan ANR meskipun memiliki layanan latar depan lain yang valid atau proses siklus proses aplikasi lainnya yang berjalan.Jika aplikasi dapat dilihat oleh pengguna atau memenuhi salah satupengecualian yang memungkinkan layanan latar depan dimulai dari latar belakang, memanggil
Service.StartForeground()
sekali lagi dengan parameterFOREGROUND_SERVICE_TYPE_SHORT_SERVICE
akan memperpanjang waktu tunggu 3 menit lagi. Jika aplikasi tidak terlihat oleh pengguna dan tidak memenuhi salah satu pengecualian, setiap upaya untuk memulai layanan latar depan lainnya, apa pun jenisnya, akan menyebabkanForegroundServiceStartNotAllowedException
.Jika pengguna menonaktifkan pengoptimalan baterai untuk aplikasi Anda, aplikasi tersebut masih terpengaruh oleh waktu tunggu shortService FGS.
Jika Anda memulai layanan latar depan yang menyertakan jenis
shortService
dan jenis layanan latar depan lainnya, sistem akan mengabaikan deklarasi jenisshortService
. Namun, layanan tetap harus mematuhi prasyarat dari jenis lain yang dideklarasikan. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Layanan latar depan.
Penggunaan khusus
- Jenis layanan latar depan untuk dinyatakan dalam manifes di bawah
android:foregroundServiceType
specialUse
- Izin untuk dideklarasikan dalam manifes Anda
FOREGROUND_SERVICE_SPECIAL_USE
- Konstanta untuk diteruskan ke
startForeground()
FOREGROUND_SERVICE_TYPE_SPECIAL_USE
- Prasyarat runtime
- Tidak ada
- Deskripsi
Mencakup semua kasus penggunaan layanan latar depan yang valid dan tidak tercakup dalam jenis layanan latar depan lainnya.
Selain mendeklarasikan jenis layanan latar depan
FOREGROUND_SERVICE_TYPE_SPECIAL_USE
, developer juga harus mendeklarasikan kasus penggunaan dalam manifes. Untuk melakukannya, mereka menentukan elemen<property>
dalam elemen<service>
. Nilai ini dan kasus penggunaan yang sesuai akan ditinjau saat Anda mengirimkan aplikasi di Konsol Google Play. Kasus penggunaan yang Anda berikan adalah bentuk bebas, dan Anda harus memastikan untuk memberikan informasi yang cukup agar peninjau memahami alasan Anda perlu menggunakan jenisspecialUse
.<service android:name="fooService" android:foregroundServiceType="specialUse"> <property android:name="android.app.PROPERTY_SPECIAL_USE_FGS_SUBTYPE" android:value="explanation_for_special_use"/> </service>
Sistem dikecualikan
- Foreground service type to declare in manifest under
android:foregroundServiceType
systemExempted
- Permission to declare in your manifest
FOREGROUND_SERVICE_SYSTEM_EXEMPTED
- Constant to pass to
startForeground()
FOREGROUND_SERVICE_TYPE_SYSTEM_EXEMPTED
- Runtime prerequisites
- None
- Description
Reserved for system applications and specific system integrations, to continue to use foreground services.
To use this type, an app must meet at least one of the following criteria:
- Device is in demo mode state
- App is a Device Owner
- App is a Profiler Owner
- Safety Apps that have the
ROLE_EMERGENCY
role - Device Admin apps
- Apps holding
SCHEDULE_EXACT_ALARM
orUSE_EXACT_ALARM
permission VPN apps (configured using Settings > Network & Internet > VPN)
Otherwise, declaring this type causes the system to throw a
ForegroundServiceTypeNotAllowedException
.
Penegakan kebijakan Google Play untuk menggunakan jenis layanan latar depan
Jika aplikasi menargetkan Android 14 atau yang lebih baru, Anda harus menyatakan jenis layanan latar depan aplikasi di halaman konten aplikasi Konsol Play (Kebijakan > Konten aplikasi). Untuk mengetahui informasi selengkapnya tentang cara mendeklarasikan jenis layanan latar depan di Konsol Play, lihat Memahami layanan latar depan dan persyaratan intent layar penuh.