Panduan AEP: Media3

Integrasikan library Jetpack Media3 sebagai standar untuk pemutaran media, sesi, pengeditan, metadata, dan ekstraksi frame untuk memastikan aplikasi menggunakan API yang direkomendasikan untuk menangani tugas media yang kompleks di berbagai faktor bentuk Android. Memodernisasi arsitektur media dengan bermigrasi dari API framework lama (seperti MediaPlayer, MediaMuxer, dan MediaExtractor) ke library Jetpack Media3 yang andal akan menyediakan toolkit terpadu dan kaya fitur yang memastikan pengalaman media yang konsisten.

Implementasi yang diperlukan

Agar memenuhi syarat untuk AEP, aplikasi Anda harus mematuhi persyaratan berikut:

  • Tidak boleh menggunakan API framework Android lama, termasuk MediaPlayer, MediaExtractor, MediaMuxer, dan MediaMetadataRetriever.
  • Jika pemutaran adalah perjalanan pengguna inti, aplikasi harus mengintegrasikan sesi media untuk kesadaran OS dan integrasi lintas perangkat.
  • Jika aplikasi memiliki library konten audio, aplikasi harus mengekspos konten melalui MediaLibraryService dan mengimplementasikan dukungan untuk pelanjutan media.

Penerapan panduan

Panduan ini berlaku untuk:

  • Aplikasi yang mendukung pemutaran media (video atau audio) atau pengeditan video.
  • Untuk semua faktor bentuk tempat aplikasi tersedia.

Pengecualian

Aplikasi dapat menggunakan framework alternatif yang setara yang memberikan kualitas, kemampuan pengguna, stabilitas, dan kompatibilitas serupa di seluruh ekosistem. Hubungi dukungan jika Anda memiliki framework yang sesuai untuk dipertimbangkan. Agar memenuhi syarat, implementasi alternatif harus memenuhi tolok ukur berikut:

  • Di jaringan yang cepat, frame video pertama harus ditampilkan dalam waktu 500 md setelah pengguna memulai.
  • Pemutaran harus tetap lancar, tanpa penurunan frame yang terlihat atau audio yang terdengar kurang selama jendela 30 detik.
  • Aplikasi harus mengelola fokus audio dengan benar.
  • Aplikasi harus merespons tombol media hardware, bahkan saat berjalan di latar belakang.
  • Jika pemutaran latar belakang didukung, aplikasi harus memposting notifikasi gaya media dan menggunakan layanan latar depan.
  • Jika aplikasi mendukung pelanjutan pemutaran, aplikasi harus mengimplementasikan pelanjutan media.
  • Pemutusan koneksi headphone harus ditangani dengan baik. Misalnya, menjeda pemutaran, bukan beralih ke speaker.
  • Pemutaran harus dilanjutkan tanpa frame yang terlewat saat beralih antara orientasi perangkat.

Dokumentasi dan referensi fitur

Referensi berikut memberikan panduan implementasi dan detail teknis tentang fitur Media3. Referensi ini hanya untuk referensi Anda dan tidak berisi persyaratan program tambahan.