Pengantar Jetpack Media3

Jetpack Media3 adalah tempat baru untuk library media yang memungkinkan aplikasi Android menampilkan pengalaman audio dan visual yang kaya. Media3 menawarkan arsitektur sederhana dengan penyesuaian, keandalan, dan pengoptimalan yang canggih berdasarkan kemampuan perangkat untuk mengabstraksi kompleksitas yang menyertai fragmentasi.

Dokumen ini memberikan pengantar tentang API utama untuk menerapkan kasus penggunaan pemutaran dan pengeditan dengan Media3.

Komponen Pemutaran

Media3 menawarkan beberapa komponen utama untuk kasus penggunaan pemutaran. Class yang membentuk komponen ini akan Anda kenal jika telah menggunakan library media Android sebelumnya.

Diagram berikut menunjukkan cara komponen ini digabungkan dalam aplikasi standar.

Berbagai komponen aplikasi media yang menggunakan Media3 terhubung bersama dengan beberapa cara sederhana karena berbagi antarmuka dan class.
Gambar 1: Komponen aplikasi media

Pemutar media

Pemutar media adalah komponen aplikasi Anda yang memungkinkan pemutaran file media. Di Media3, Anda akan menemukan:

Class Deskripsi Catatan penerapan
Player Player adalah antarmuka yang menentukan kemampuan tingkat tinggi tradisional untuk pemutar media, seperti kemampuan untuk memutar, menjeda, dan mencari. Di Media3, antarmuka Player adalah API umum yang diterapkan atau digunakan oleh beberapa komponen, misalnya MediaSession dan MediaController.
ExoPlayer ExoPlayer adalah implementasi default antarmuka Player di Media3.

Pelajari Media3 ExoPlayer lebih lanjut

Sesi media

Sesi media menyediakan cara universal untuk berinteraksi dengan pemutar media. Hal ini memungkinkan aplikasi mengiklankan pemutaran media ke sumber eksternal dan menerima permintaan kontrol pemutaran dari sumber eksternal. Di Media3, Anda akan menemukan:

Class Deskripsi Catatan penerapan
MediaSession Sesi media memungkinkan aplikasi Anda berinteraksi dengan pemutar audio atau video. Iklan tersebut mengiklankan pemutaran media secara eksternal dan menerima perintah pemutaran dari sumber eksternal. Di Media3, MediaSession memerlukan Player untuk menjalankan perintah dan mendapatkan status saat ini.
MediaSessionService MediaSessionService menyimpan sesi media dan pemutar terkait dalam layanan yang terpisah dari Activity utama aplikasi Anda untuk memfasilitasi pemutaran latar belakang.
MediaController Class MediaController umumnya digunakan untuk mengirim perintah dari luar aplikasi Anda, misalnya, dari aplikasi lain atau sistem itu sendiri. Perintah dikirim ke Player yang mendasari MediaSession terkait. Class MediaController mengimplementasikan antarmuka Player, tetapi saat memanggil metode, MediaController mengirim perintah yang dikirim ke MediaSession yang terhubung. Aplikasi klien seperti Asisten Google dapat menggunakan MediaController untuk mengontrol pemutaran dalam sesi yang terhubung.
MediaLibraryService MediaLibraryService mirip dengan MediaSessionService, kecuali bahwa library ini menyertakan API tambahan sehingga Anda dapat menayangkan library konten ke aplikasi klien.
MediaBrowser Class MediaBrowser memungkinkan pengguna menjelajahi library konten aplikasi media dan memilih item yang akan diputar. Class MediaBrowser mengimplementasikan antarmuka MediaController dan Player. Serupa dengan MediaController, aplikasi klien seperti Android Auto umumnya menerapkan MediaBrowser.

Pelajari MediaSession Media3 lebih lanjut

Komponen UI

Media3 menyediakan komponen UI default untuk melihat video dan mengontrol pemutaran.

Class Deskripsi Catatan penerapan
PlayerView View default untuk menampilkan kontrol pemutaran dan video. Menghubungkan ke ExoPlayer, MediaController, atau Player kustom lainnya.
PlayerSurface Composable yang mewakili Surface gambar khusus untuk menampilkan video. Terhubung ke Player mana pun, tetapi tidak berisi kontrol pemutaran. Hanya digunakan untuk merender frame dan dapat diubah ukurannya sesuai dengan berbagai jenis ContentScale. Composable ini dan banyak composable lainnya dapat ditemukan di utilitas UI Compose.

Pelajari UI Media3 lebih lanjut

Mengedit komponen

Media3 menyertakan Transformer API untuk kasus penggunaan pengeditan media, termasuk:

  • Pemrosesan audio dan video, seperti menambahkan filter dan efek
  • Menangani format khusus, seperti video HDR dan video slow motion
  • Komposisi, seperti menggabungkan beberapa file input
  • Mengekspor output akhir ke file
Class Deskripsi Catatan penerapan
Transformer Gunakan class Transformer untuk memulai dan menghentikan transformasi serta untuk memeriksa pembaruan progres pada transformasi yang sedang berjalan.
Effects Objek Effects adalah kumpulan efek audio dan video yang akan diterapkan ke item media.
EditedMediaItem EditedMediaItem mewakili item media yang akan diproses dan pengeditan yang akan diterapkan padanya. Anda dapat menggunakan ExoPlayer untuk melihat pratinjau efek yang ditambahkan ke item media sebelum memulai proses ekspor.

Pelajari Transformator Media3 lebih lanjut

Video pengantar

Tonton video di bawah untuk melihat pengantar Media3 dari engineer yang membuatnya.