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 memigrasikan dari API framework lama (seperti MediaPlayer, MediaMuxer, dan MediaExtractor) ke library Jetpack Media3 yang tangguh memberikan toolkit terpadu dan kaya fitur yang memastikan pengalaman media yang konsisten.

Penerapan yang diperlukan

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

ID Panduan
AEP-M3-GAA Tidak boleh menggunakan API framework Android lama, termasuk MediaPlayer, MediaExtractor, MediaMuxer, dan MediaMetadataRetriever.
AEP-M3-GAB Jika pemutaran adalah perjalanan pengguna inti, aplikasi harus mengintegrasikan sesi media untuk deteksi OS dan integrasi lintas perangkat.
AEP-M3-GAC Jika aplikasi memiliki library konten audio, aplikasi harus mengekspos konten melalui MediaLibraryService dan mengimplementasikan dukungan untuk kelanjutan media.

Penerapan pedoman

Pedoman 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 yang serupa di seluruh ekosistem. Hubungi dukungan jika Anda memiliki framework yang sesuai untuk dipertimbangkan. Agar memenuhi syarat, penerapan alternatif harus memenuhi tolok ukur berikut:

ID Pembebasan
AEP-M3-EAA 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 kekurangan audio yang terdengar selama periode 30 detik.
Aplikasi harus mengelola fokus audio dengan benar.
Aplikasi harus merespons tombol media hardware, meskipun berjalan di latar belakang.
Jika pemutaran di latar belakang didukung, aplikasi harus memposting notifikasi gaya media dan menggunakan layanan latar depan.
Jika aplikasi mendukung melanjutkan pemutaran, aplikasi harus menerapkan kelanjutan media.
Pelepasan headphone harus ditangani dengan baik. Misalnya, menjeda pemutaran, bukan beralih ke speaker.
Pemutaran harus dilanjutkan tanpa frame yang terputus saat beralih antara orientasi perangkat.

Dokumentasi dan referensi fitur

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