ExoPlayer: τι είναι, δυνατότητες και ρύθμιση

Τι είναι το ExoPlayer;

ExoPlayer είναι μια βιβλιοθήκη αναπαραγωγής πολυμέσων για Android με ανοικτό κώδικα (Apache 2.0), της οποίας η πρώτη έκδοση κυκλοφόρησε από την Google το 2014. Σε αντίθεση με το ενσωματωμένο MediaPlayer, το οποίο είναι ένα λεπτό στρώμα πάνω από τον κωδικοποιητή πολυμέσων συστήματος (MediaCodec), το ExoPlayer υλοποιείται εξ ολοκλήρου σε επίπεδο Java/Kotlin, δίνοντας στους προγραμματιστές πλήρη έλεγχο σε κάθε στάδιο αναπαραγωγής.

Αρχιτεκτονικά, το ExoPlayer είναι χτισμένο πάνω στην αρθρωτή αρχή: κάθε πτυχή της αναπαραγωγής υλοποιείται από ξεχωριστό στοιχείο. Η κύρια μονάδα (exoplayer-core) περιέχει το πρόγραμμα αναπαραγωγής, τους αποδότες, τους επιλογείς κομματιών και τη διαχείριση προσωρινής μνήμης. Πρόσθετες μονάδες (exoplayer-dash, exoplayer-hls, exoplayer-rtsp, exoplayer-smoothstreaming) προσθέτουν υποστήριξη για τα αντίστοιχα πρωτόκολλα ροής. Αυτή η αρχιτεκτονική επιτρέπει στις εφαρμογές να συνδέουν μόνο τα απαραίτητα στοιχεία, ελαχιστοποιώντας το μέγεθος APK.

ExoPlayer 2 (η τρέχουσα κύρια έκδοση) κυκλοφόρησε το 2018 και έφερε ριζική αναθεώρηση του API: εισαγωγή του Player Interface, υποστήριξη Compose μέσω AndroidX Media3, βελτιωμένη διαχείριση σφαλμάτων και προσαρμοστικούς αλγόριθμους επιλογής κομματιών. Από την έκδοση 2.19 (2024), το ExoPlayer έγινε μέρος της βιβλιοθήκης AndroidX Media, απλοποιώντας την ενσωμάτωση και την ενημέρωση μέσω του τυπικού διαχειριστή εξαρτήσεων Android.

Αρχιτεκτονική ExoPlayer

Στον πυρήνα του ExoPlayer βρίσκεται το στοιχείο ExoPlayerImpl, το οποίο διαχειρίζεται τον κύκλο ζωής της αναπαραγωγής. Περιέχει MediaSource (πηγή πολυμέσων), TrackSelector (επιλογή κομματιών), LoadControl (διαχείριση προσωρινής αποθήκευσης) και μια λίστα Renderer (αποδότες για βίντεο, ήχο, υπότιτλους και μεταδεδομένα). Κάθε στοιχείο μπορεί να αντικατασταθεί με δική σας υλοποίηση μέσω Builder ή μεθόδων εργοστασίου.

Για την απόδοση βίντεο, το ExoPlayer χρησιμοποιεί SurfaceView, TextureView ή SphericalSurfaceView (για βίντεο 360 μοιρών). Η συνιστώμενη επιλογή είναι το SurfaceView, καθώς παρέχει επιτάχυνση υλικού και ελάχιστη κατανάλωση ενέργειας. Για το Jetpack Compose, η βιβλιοθήκη AndroidX Media3 παρέχει το στοιχείο `AndroidView`, που τυλίγει το SurfaceView, και το πειραματικό `Media3Compose` με εγγενή ενσωμάτωση Compose.

Δυνατότητες ExoPlayer

ExoPlayer παρέχει ένα ευρύ φάσμα λειτουργιών που ξεπερνούν ένα συνηθισμένο πρόγραμμα αναπαραγωγής πολυμέσων. Οι κύριες δυνατότητες περιλαμβάνουν υποστήριξη για όλα τα δημοφιλή πρωτόκολλα ροής, ευέλικτο σύστημα DRM, προσαρμοστική εναλλαγή bitrate (ABR) και εργαλεία ανάλυσης αναπαραγωγής.

Προσαρμοστική εναλλαγή bitrate

ABR (Adaptive Bitrate) στο ExoPlayer υλοποιείται μέσω της διεπαφής AdaptiveTrackSelection. Από προεπιλογή, χρησιμοποιείται το AdaptiveTrackSelectionFactory, το οποίο δημιουργεί DefaultAdaptiveTrackSelection — έναν ισορροπημένο αλγόριθμο που λαμβάνει υπόψη το εύρος ζώνης δικτύου και το μέγεθος προσωρινής μνήμης. Για συγκεκριμένα σενάρια, μπορούν να συνδεθούν εναλλακτικές υλοποιήσεις: BOLA (ελαχιστοποίηση εναλλαγών), RandomAdaptiveTrackSelection (δοκιμή) ή δική σας υλοποίηση μέσω της διεπαφής TrackSelection.

BandwidthMeter είναι ένα άλλο βασικό στοιχείο υπεύθυνο για τη μέτρηση του εύρους ζώνης δικτύου. Από προεπιλογή, χρησιμοποιείται το DefaultBandwidthMeter, το οποίο συλλέγει στατιστικά από όλα τα αιτήματα HTTP του προγράμματος αναπαραγωγής. Ο προγραμματιστής μπορεί να το επεκτείνει για να λάβει υπόψη πρόσθετους παράγοντες: τύπο δικτύου (Wi-Fi, 4G, 5G), σήμα κεραίας κινητής ή κόστος κίνησης για τον χρήστη.

DRM και προστασία περιεχομένου

ExoPlayer υποστηρίζει Widevine (L1, L3), PlayReady και ClearKey DRM. Η λήψη άδειας διαμορφώνεται μέσω του DrmSessionManager, το οποίο αλληλεπιδρά με τον διακομιστή αδειών. Για βίντεο υψηλής ποιότητας (4K HDR) απαιτείται υποστήριξη υλικού Widevine L1, η οποία παρέχει προστασία σε επίπεδο τσιπ και αποτρέπει τη λήψη οθόνης. Η επιλογή συστήματος DRM εξαρτάται από την πλατφόρμα-στόχο: το Widevine χρησιμοποιείται σε Android και Chromecast, το PlayReady σε Xbox και Windows, το FairPlay σε iOS και Apple TV. Το ExoPlayer καθορίζει αυτόματα το διαθέσιμο σύστημα DRM βάσει του αρχείου MPD και δεν απαιτεί χειροκίνητη διαμόρφωση για βασικά σενάρια.

Πώς να ενσωματώσετε το ExoPlayer σε έργο Android

Η σύνδεση του ExoPlayer σε έργο Android γίνεται μέσω εξαρτήσεων Gradle. Από την έκδοση 2.19, το ExoPlayer αποτελεί μέρος του AndroidX Media (androidx.media3), εξασφαλίζοντας συμβατότητα με το Jetpack Compose και άλλα στοιχεία AndroidX. Ας δούμε τη βήμα προς βήμα ενσωμάτωση σε Kotlin.

Προσθήκη εξαρτήσεων

Προσθέστε τις μονάδες ExoPlayer στο αρχείο build.gradle (Module). Το ελάχιστο σετ περιλαμβάνει core, ui και τη μονάδα για το απαιτούμενο πρωτόκολλο ροής. Για αναπαραγωγή περιεχομένου DASH απαιτείται exoplayer-dash, για HLS — exoplayer-hls.

dependencies {
    implementation "androidx.media3:media3-exoplayer:1.5.0"
    implementation "androidx.media3:media3-ui:1.5.0"
    implementation "androidx.media3:media3-exoplayer-dash:1.5.0"
    implementation "androidx.media3:media3-exoplayer-hls:1.5.0"
}

Βασική ενσωμάτωση σε Activity

Δημιουργία και ρύθμιση του προγράμματος αναπαραγωγής σε Activity ή Fragment. Το ExoPlayer χρησιμοποιεί PlayerView (ή StyledPlayerView για προσαρμογή) για την εμφάνιση βίντεο και ενσωματωμένων στοιχείων ελέγχου. Η ελάχιστη διαμόρφωση περιλαμβάνει τη δημιουργία του προγράμματος αναπαραγωγής μέσω ExoPlayer.Builder και τη μετάδοση ενός MediaItem με το URI της πηγής.

class PlayerActivity : AppCompatActivity() {

    private var player: ExoPlayer? = null

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_player)

        player = ExoPlayer.Builder(this).build()
        val playerView = findViewById<StyledPlayerView>(R.id.playerView)
        playerView.player = player

        val mediaItem = MediaItem
            .Builder()
            .setUri("https://example.com/video.mp4")
            .build()
        player?.setMediaItem(mediaItem)
        player?.prepare()
    }

    override fun onDestroy() {
        player?.release()
        super.onDestroy()
    }
}

Διαχείριση σφαλμάτων και καταστάσεων

Για εφαρμογές παραγωγής, απαιτείται διαχείριση πιθανών σφαλμάτων αναπαραγωγής: αποτυχίες δικτύου, μη υποστηριζόμενες μορφές, σφάλματα αδειοδότησης DRM. Το ExoPlayer παρέχει τη διεπαφή Player.Listener με μεθόδους onPlayerError, onPlaybackStateChanged και onPlayWhenReadyChanged. Συνιστάται η εμφάνιση ενημερωτικών μηνυμάτων σφάλματος με δυνατότητα επανάληψης.

ExoPlayer εναντίον MediaPlayer: σύγκριση

Η επιλογή μεταξύ ExoPlayer και ενσωματωμένου MediaPlayer είναι συχνή ερώτηση κατά την ανάπτυξη εφαρμογών Android. Το MediaPlayer αποτελεί μέρος του Android SDK από την έκδοση 1.0, ενώ το ExoPlayer είναι μια βιβλιοθήκη που απαιτεί σύνδεση μέσω Gradle. Ας δούμε τις διαφορές τους βάσει βασικών κριτηρίων.

ExoPlayer υπερτερεί σε σενάρια που απαιτούν ροή (DASH, HLS), προσαρμογή UI, υποστήριξη DRM και ανεξαρτησία από την έκδοση Android. Το MediaPlayer είναι κατάλληλο για απλές εφαρμογές που αναπαράγουν τοπικά αρχεία πολυμέσων, όπου το μέγεθος APK είναι κρίσιμο και δεν υπάρχουν απαιτήσεις για προσαρμοστική ροή. Για σύγχρονες εφαρμογές με περιεχόμενο από δίκτυο, το ExoPlayer είναι η προφανής επιλογή.

Εξαίρεση — εφαρμογές με ελάχιστο SDK κάτω από API 16 (Android 4.1), οι οποίες πρακτικά δεν υπάρχουν πλέον στην αγορά. Για όλες τις εφαρμογές με targetSdk 33+ και ελάχιστο SDK 21+, το ExoPlayer δεν είναι απλώς προτιμητέο, αλλά απαραίτητο για την υποστήριξη σύγχρονων μορφών όπως AV1 και Dolby Vision μέσω των κατάλληλων επεκτάσεων.

Προηγμένη ρύθμιση ExoPlayer

Για εφαρμογές παραγωγής, η βασική ενσωμάτωση ExoPlayer συχνά απαιτεί πρόσθετη ρύθμιση: διαχείριση προσωρινής αποθήκευσης, βελτιστοποίηση προσωρινής μνήμης για κινητά δίκτυα, ενσωμάτωση με αναλυτικά στοιχεία και προσαρμογή επιλογής κομματιών ήχου. Ας δούμε προηγμένα σενάρια χρήσης.

Προσωρινή αποθήκευση περιεχομένου

CacheDataSourceFactory επιτρέπει την προσωρινή αποθήκευση ληφθέντων τμημάτων στην τοπική μνήμη, εξοικονομώντας κίνηση κατά την επαναλαμβανόμενη παρακολούθηση και παρέχοντας αναπαραγωγή εκτός σύνδεσης. Το ExoPlayer χρησιμοποιεί SimpleCache από τη βιβλιοθήκη exoplayer-cas — προσωρινή αποθήκευση αρχείων με υποστήριξη LRU εκκένωσης και περιορισμών μεγέθους.

val cache = SimpleCache(
    cacheDir,
    LeastRecentlyUsedCacheEvictor(50 * 1024 * 1024),
    AppDatabaseProvider(this)
)

val cacheDataSourceFactory = CacheDataSource
    .Factory()
    .setCache(cache)

val player = ExoPlayer.Builder(this)
    .setMediaSourceFactory(
        DefaultMediaSourceFactory(cacheDataSourceFactory)
    )
    .build()

Διαχείριση εναλλαγής δικτύου

Σε εφαρμογές κινητών, η διαχείριση εναλλαγής μεταξύ Wi-Fi και κινητού δικτύου είναι κρίσιμη. Το ExoPlayer παρέχει ConnectivityManager για παρακολούθηση της κατάστασης δικτύου. Κατά την απώλεια σύνδεσης, συνιστάται να μην σταματάτε το πρόγραμμα αναπαραγωγής, αλλά να το μεταφέρετε σε κατάσταση PAUSED με διατήρηση της θέσης. Μετά την αποκατάσταση σύνδεσης, συνεχίστε την αναπαραγωγή με επαναφόρτωση των τμημάτων.

Ενσωμάτωση με Jetpack Compose

Με την κυκλοφορία του AndroidX Media3, η βιβλιοθήκη έλαβε πειραματική υποστήριξη για Jetpack Compose. Το στοιχείο `AndroidView` τυλίγει το SurfaceView ή το PlayerView, εξασφαλίζοντας συμβατότητα με την ιεραρχία Compose. Για βαθύτερη ενσωμάτωση, χρησιμοποιείται η βιβλιοθήκη `androidx.media3:media3-ui-compose`, η οποία παρέχει στοιχεία ελέγχου συμβατά με Compose για το πρόγραμμα αναπαραγωγής.

@Composable
fun VideoPlayer(uri: String) {
    val context = LocalContext.current
    val player = remember {
        ExoPlayer.Builder(context).build()
            .also { it.setMediaItem(MediaItem.fromUri(uri)) }
    }

    DisposableEffect(key = null) {
        player.prepare()
        onDispose { player.release() }
    }

    AndroidView(
        factory = { StyledPlayerView(context).also { it.player = player } }
    )
}