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 muncul akibat 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 terasa familiar bagi Anda jika Anda pernah 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, termasuk MediaSession dan MediaController, misalnya.
ExoPlayer ExoPlayer adalah implementasi default antarmuka Player di Media3.

Pelajari lebih lanjut Media3 ExoPlayer

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. Mereka 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 terkaitnya dalam layanan yang terpisah dari Activity utama aplikasi Anda untuk memfasilitasi pemutaran di 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 di sesi yang terhubung.
MediaLibraryService MediaLibraryService mirip dengan MediaSessionService, kecuali bahwa MediaLibraryService menyertakan API tambahan sehingga Anda dapat menayangkan koleksi konten ke aplikasi klien.
MediaBrowser Class MediaBrowser memungkinkan pengguna menjelajahi koleksi konten aplikasi media dan memilih item yang akan diputar. Class MediaBrowser mengimplementasikan antarmuka MediaController dan Player. Mirip dengan MediaController, aplikasi klien seperti Android Auto umumnya menerapkan MediaBrowser.

Pelajari lebih lanjut MediaSession Media3

Komponen UI

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

Class Deskripsi Catatan penerapan
PlayerView View default untuk menampilkan kontrol video dan pemutaran. Menghubungkan ke ExoPlayer, MediaController, atau Player kustom lainnya.
PlayerSurface Composable yang merepresentasikan gambar khusus Surface untuk menampilkan video. Terhubung ke Player apa 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 lebih lanjut UI Media3

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 gerak lambat
  • 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 update progres pada transformasi yang sedang berjalan.
Effects Objek Effects adalah kumpulan efek audio dan video untuk diterapkan ke item media. Anda dapat menggunakan ExoPlayer untuk melihat pratinjau efek yang ditambahkan ke item media sebelum memulai proses ekspor.
EditedMediaItem EditedMediaItem merepresentasikan item media yang akan diproses dan pengeditan yang akan diterapkan padanya.

Pelajari lebih lanjut Transformator Media3

Video pengantar

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