Memahami persyaratan layanan latar depan dan intent layar penuh

Agar developer dapat membuat aplikasi yang tidak hanya memberikan pengalaman pengguna yang konsisten, kami memperkenalkan jenis layanan latar depan tambahan beserta serangkaian batasan kebijakan terkait yang baru. Artikel ini menjelaskan persyaratan layanan latar depan mendatang dan cara menyatakan informasi layanan latar depan di Konsol Play. Artikel ini juga menjelaskan persyaratan untuk menggunakan notifikasi intent layar penuh.

Persyaratan layanan latar depan untuk Android 14

Untuk membantu Anda mengidentifikasi kasus penggunaan mana yang sesuai untuk layanan latar depan dan menentukan intent tugas latar belakang aplikasi dengan jelas, Android 14 dan yang lebih baru mengharuskan Anda melakukan hal berikut sebelum menggunakan layanan latar depan:

  • Menyatakan jenis layanan latar depan dalam manifes Anda. Anda harus melakukan hal ini untuk setiap layanan latar depan yang ingin digunakan.
  • Jika berlaku untuk jenis yang dipilih, nyatakan dan minta izin layanan latar depan yang sesuai untuk setiap jenis layanan latar depan.

Bagian Izin untuk Layanan Latar Depan (FGS)dalam kebijakan Penyalahgunaan Perangkat dan Jaringan kami menguraikan kriteria yang diperlukan untuk menggunakan layanan latar depan secara mendetail. Anda harus menyatakan jenis layanan latar depan saat mengupdate ke Android 14.

Menyatakan informasi layanan latar depan di Konsol Play

Jika aplikasi menargetkan Android 14 dan yang lebih baru, Anda harus menyatakan semua jenis layanan latar depan yang digunakan dalam pernyataan baru di halaman Konten aplikasi (Kebijakan > Konten aplikasi) di Konsol Play.

Untuk setiap jenis layanan latar depan yang dinyatakan, Anda harus melakukan hal berikut:

  1. Memberikan deskripsi fungsi aplikasi yang menggunakan setiap jenis layanan latar depan.
  2. Menjelaskan dampak terhadap pengguna jika:
    • tugas ditunda oleh sistem (tidak segera dimulai); dan/atau
    • tugas diganggu oleh sistem (dijeda dan/atau dimulai ulang).
  3. Menyertakan link ke video yang menunjukkan setiap fitur layanan latar depan. Video harus menunjukkan langkah-langkah yang perlu dilakukan pengguna di aplikasi Anda untuk memicu fitur.
  4. Pilih kasus penggunaan spesifik Anda untuk setiap jenis layanan latar depan. Daftar kasus penggunaan preset akan disediakan untuk Anda pilih. Kasus penggunaan tertentu yang dipetakan ke jenis layanan latar depan tercantum dalam diagram di bawah. Daftar ini tidak lengkap; jika kasus penggunaan Anda tidak tercantum, Anda dapat memasukkan kasus penggunaan secara manual.

    Untuk kasus penggunaan tertentu, sebaiknya gunakan API alternatif. Untuk melihat daftar kasus penggunaan tersebut dan API alternatifnya yang direkomendasikan, buka situs Android Developers.

Catatan: Daftar di bawah ini tidak lengkap. Untuk menentukan apakah akses sesuai untuk FGS, lihat kebijakan Izin untuk Layanan Latar Depan (FGS) untuk kasus penggunaan yang tidak disebutkan di bawah.

Jenis Layanan Latar Depan Kasus Penggunaan Deskripsi dan Contoh
TYPE_CAMERA Streaming Kamera Latar Belakang Terus mengakses kamera dari latar belakang. Misalnya, aplikasi video chat yang memungkinkan multitasking.
TYPE_CONNECTED_DEVICE Transfer Data secara terus-menerus ke Perangkat Eksternal Interaksi dengan perangkat eksternal, termasuk transfer data yang memerlukan Bluetooth, NFC, IR, USB, atau koneksi jaringan. Misalnya, perangkat wearable, monitor bayi, headset, mobil.
TYPE_DATA_SYNC Transfer jaringan: Pencadangan dan pemulihan Gunakan untuk fitur yang dimulai oleh pengguna secara khusus. Misalnya, memilih foto tertentu untuk dicadangkan ke cloud vs pencadangan otomatis harian untuk semua foto baru.
Transfer jaringan: Mengupload atau mendownload Misalnya, pengambilan data, pemrosesan sisi server.
Pemrosesan lokal: Transcoding Media Proses konversi file media, seperti audio dan video, dari satu format ke format lainnya (misalnya, fitur seperti pengeditan video).
Pemrosesan lokal: Impor atau ekspor Termasuk migrasi file dari kartu SD.
Pemrosesan lokal: Lainnya Gunakan untuk pekerjaan yang dimulai oleh pengguna secara khusus dan bukan untuk tugas reguler yang dimulai oleh sistem atau server. Misalnya, enkripsi, pengubahan ukuran.
TYPE_HEALTH Sinkronisasi Data Kesehatan Menyinkronkan data kesehatan untuk aplikasi dalam kategori kebugaran, yang dapat dilakukan di berbagai aplikasi atau untuk mengumpulkan data yang dikumpulkan melalui pelacakan di perangkat. Misalnya, penghitung langkah, pelacak latihan.
TYPE_LOCATION Pembaruan Lokasi Latar Belakang: Berbagi lokasi yang dimulai oleh pengguna Misalnya, fitur Find My Friend, pelacakan aktivitas kendaraan.
Pembaruan Lokasi Latar Belakang: Navigasi Misalnya, melanjutkan navigasi mengemudi di peta, pelacakan perjalanan untuk transportasi online.
Pembatasan wilayah Menentukan parameter, yang mengelilingi area minat.
TYPE_MEDIA_PLAYBACK Pemutaran Media Melanjutkan pemutaran audio atau video dari latar belakang, termasuk streaming.
Tampilkan Picture-in-Picture Saat media dalam format diperkecil ketika diputar di latar belakang.
TYPE_MEDIA_PROJECTION Proyeksi Media atau Konten dan streaming atau perekaman dengan MediaProjection API Memproyeksikan media ke layar non-utama atau perangkat eksternal menggunakan MediaProjection API, termasuk streaming.
TYPE_MICROPHONE Akses Audio Latar Belakang Merekam input audio, misalnya, perintah suara untuk asisten virtual tanpa menyimpan, rekaman suara manusia.
TYPE_PHONE_CALL Memanggil: API Seluler/VoiP/Telecom Mendukung berbagai fitur telepon.
TYPE_REMOTE_MESSAGING Menyampaikan komunikasi teks ke perangkat lain Memandu tanpa kontinuitas tugas fitur pesan pengguna saat mereka beralih perangkat. Misalnya, izinkan pengguna mengirim pesan teks melalui klien web dengan memindai kode QR dan membuat koneksi antara klien web dan ponsel. Tidak terbatas pada SMS.

Pernyataan akan tersedia mulai November 2023, dan kami akan memberi Anda waktu untuk menyelesaikan pernyataan, menerima masukan, serta membuat penyesuaian jika diperlukan.

Persyaratan intent layar penuh untuk Android 14

Ada baiknya Anda menggunakan notifikasi intent layar penuh untuk membagikan pesan berprioritas tinggi yang memerlukan perhatian langsung pengguna. Untuk memastikan izin ini terbatas pada kasus penggunaan prioritas tinggi yang tepat, untuk Android 14, kami memperkenalkan batasan untuk penggunaan izin USE_FULL_SCREEN_INTENT. Membatasi notifikasi dengan cara ini membantu memastikan pengalaman yang lebih baik bagi pengguna.

Jika Anda menggunakan izin USE_FULL_SCREEN_INTENT, Anda wajib melengkapi pernyataan Konsol Play mulai 31 Mei 2024 untuk menunjukkan apakah aplikasi Anda memiliki fungsi inti yang diizinkan dan memenuhi syarat untuk pemberian otomatis. Mulai 22 Januari 2025, untuk aplikasi yang menargetkan Android 14+, hanya aplikasi yang memiliki fungsi panggilan atau alarm yang izinnya akan diaktifkan secara default. Jika tidak, Anda harus mendapatkan izin pengguna untuk menggunakan izin USE_FULL_SCREEN_INTENT. Untuk aplikasi yang tidak melengkapi pernyataan atau belum disetujui untuk pengaktifan secara default, developer akan perlu meminta pengguna memberikan izin pada penginstalan baru dan menurunkan pengalaman dengan baik jika ditolak.

Pertanyaan umum (FAQ)

Apa yang berubah untuk layanan latar depan di Android 14?

Kami akan memperkenalkan beberapa jenis layanan latar depan baru, dan akan mewajibkan pernyataan jenis layanan latar depan beserta izin layanan latar depan yang sesuai. Misalnya, jika menyatakan jenis layanan latar depan "kamera", Anda juga harus menyatakan izin FOREGROUND_SERVICE_CAMERA. Penggunaan latar depan juga harus mematuhi persyaratan lain yang diuraikan dalam kebijakan Penyalahgunaan Perangkat dan Jaringan.

Bagaimana cara mengetahui jenis layanan latar depan yang akan digunakan?

Pilih jenis layanan latar depan yang paling cocok dengan penggunaan layanan latar depan yang diinginkan. Misalnya, aplikasi olahraga yang memantau aktivitas olahraga yang dilakukan pengguna dapat menyatakan jenis layanan latar depan "kesehatan". Anda juga dapat memilih beberapa jenis layanan latar depan jika sesuai untuk aplikasi Anda.

Apa yang dimaksud dengan izin layanan latar depan dan apakah izin harus diberikan oleh pengguna sebelum memulai layanan latar depan?

Jika aplikasi yang menargetkan Android 14 menggunakan layanan latar depan, developer harus menyatakan izin layanan latar depan yang sesuai untuk jenis layanan latar depan tersebut. Misalnya, jika aplikasi Anda menggunakan jenis layanan latar depan "lokasi", Anda harus menyatakan izin FOREGROUND_SERVICE_LOCATION. Izin layanan latar depan yang merujuk pada jenis layanan latar depan tertentu didefinisikan sebagai izin normal dan diberikan secara default pada saat penginstalan. Pengguna tidak dapat mencabut izin ini.

Apakah ada persyaratan tambahan selain menyatakan izin layanan latar depan yang sesuai?

Bergantung pada jenis layanan latar depan, mungkin ada persyaratan sistem tambahan. Beberapa di antaranya mungkin izin runtime dan mengharuskan pengguna memberikan izin sebelum dapat digunakan. Misalnya, jika menggunakan jenis layanan latar depan “lokasi”, pengguna juga harus memberikan izin ACCESS_COARSE_LOCATION atau ACCESS_FINE_LOCATION. Harap baca dokumentasi untuk mendapatkan informasi terbaru.

Bagaimana jika kasus penggunaan latar depan saya tidak sesuai dengan jenis layanan latar depan mana pun?

Dalam skenario terbatas, jika kasus penggunaan Anda memenuhi karakteristik lain yang diwajibkan untuk penggunaan layanan latar depan (seperti yang dijelaskan dalam kebijakan), Anda dapat menyatakan jenis layanan latar depan TYPE_SPECIAL_USE. Semua jenis layanan latar depan melalui proses peninjauan.

Apa yang dimaksud dengan "dapat disimak pengguna"?

Dapat disimak pengguna berarti pengguna harus mengetahui bahwa tugas layanan latar depan sedang berjalan di perangkatnya. Pengguna dapat dianggap mengetahui jika mereka sendiri yang memulai tindakan itu; misalnya, pengguna mungkin memutar lagu atau melacak aktivitas berlari. Aplikasi Anda juga dapat membuat pengguna mengetahui layanan latar depan yang sedang berlangsung dengan menampilkan notifikasi yang jelas dan akurat di taskbar perangkat.

Bagaimana jika saya menargetkan versi sebelum Android 14?

Jika Anda menargetkan versi Android sebelum Android 14, terus gunakan atribut android:foregroundServiceType dalam elemen <service> file manifes aplikasi Anda.

Apa perbedaan antara jenis layanan latar depan dataSync dan Transfer Data yang Dimulai oleh Pengguna?

Tugas transfer data yang dimulai oleh pengguna dirancang untuk memudahkan transfer data melalui jaringan. Tugas ini memiliki pelacakan batasan dan mengelola wakelock secara otomatis. Jenis layanan latar depan dataSync dapat mencakup transfer data secara lokal atau melalui jaringan, dan dapat mencakup pemrosesan data secara lokal di perangkat. Jika kasus penggunaan Anda adalah untuk mentransfer data melalui jaringan (seperti Wi-Fi, seluler, atau Bluetooth) sebagai respons terhadap permintaan pengguna yang eksplisit, sebaiknya gunakan tugas transfer data yang dimulai oleh pengguna, bukan jenis layanan latar depan dataSync.

Apa yang berubah untuk intent layar penuh di Android 14?

Untuk Android 14, USE_FULL_SCREEN_INTENT akan beralih dari izin normal ke izin akses aplikasi khusus, dan hanya aplikasi yang fungsi intinya merupakan kasus penggunaan prioritas tinggi untuk menyetel alarm atau menerima panggilan telepon atau video yang akan otomatis diberi izin USE_FULL_SCREEN_INTENT. Anda dapat menganggap fungsi inti sebagai tujuan utama aplikasi, yang tanpanya aplikasi akan rusak atau tidak dapat digunakan. Aplikasi lain mungkin masih menggunakan izin tersebut, tetapi hanya setelah aplikasi mendapatkan izin dari pengguna.

Kapan perubahan untuk intent layar penuh di Android 14 ini akan berlaku?

Perubahan ini akan berlaku pada 31 Mei 2024.

Jika aplikasi saya adalah aplikasi jam alarm atau aplikasi yang menerima panggilan telepon atau panggilan video, bagaimana cara memastikan aplikasi saya otomatis diberi izin?

Jika aplikasi Anda menargetkan Android 14 dan yang lebih baru, Anda akan memiliki opsi untuk menyatakan bahwa aplikasi Anda adalah aplikasi fungsi inti untuk intent layar penuh di halaman Konten aplikasi (Kebijakan > Konten aplikasi) di Konsol Play. Pernyataan akan tersedia mulai April 2024, dan kami akan memberi Anda waktu untuk melengkapi pernyataan tersebut.

Apakah ini membantu?

Bagaimana cara meningkatkannya?

Perlu bantuan lain?

Coba langkah-langkah selanjutnya berikut:

Telusuri
Hapus penelusuran
Tutup penelusuran
Menu utama
1019997641939450842
true
Pusat Bantuan Penelusuran
true
true
true
true
true
92637
false
false