ExoPlayer: co to je, možnosti a nastavení

Co je ExoPlayer?

ExoPlayer je knihovna pro přehrávání multimédií na Androidu s otevřeným zdrojovým kódem (Apache 2.0), jejíž první verze byla vydána společností Google v roce 2014. Na rozdíl od vestavěného MediaPlayer, který je tenkou vrstvou nad systémovým multimediálním kodekem (MediaCodec), je ExoPlayer implementován zcela na úrovni Java/Kotlin, což dává vývojářům plnou kontrolu nad každou fází přehrávání.

Architektonicky je ExoPlayer postaven na modulárním principu: každý aspekt přehrávání je implementován samostatnou komponentou. Hlavní modul (exoplayer-core) obsahuje přehrávač, renderery, selektory stop a správu vyrovnávací paměti. Další moduly (exoplayer-dash, exoplayer-hls, exoplayer-rtsp, exoplayer-smoothstreaming) přidávají podporu pro příslušné streamovací protokoly. Tato architektura umožňuje aplikacím připojit pouze potřebné komponenty, čímž se minimalizuje velikost APK.

ExoPlayer 2 (aktuální hlavní verze) byl vydán v roce 2018 a přinesl zásadní přepracování API: zavedení Player Interface, podporu Compose přes AndroidX Media3, vylepšené zpracování chyb a adaptivní algoritmy výběru stop. Od verze 2.19 (2024) se ExoPlayer stal součástí knihovny AndroidX Media, což zjednodušilo integraci a aktualizaci prostřednictvím standardního správce závislostí Android.

Architektura ExoPlayer

Základem ExoPlayer je komponenta ExoPlayerImpl, která spravuje životní cyklus přehrávání. Obsahuje MediaSource (zdroj médií), TrackSelector (výběr stop), LoadControl (správa bufferování) a seznam Renderer (renderery pro video, audio, titulky a metadata). Každá komponenta může být nahrazena vlastní implementací pomocí Builder nebo továrních metod.

Pro vykreslování videa používá ExoPlayer SurfaceView, TextureView nebo SphericalSurfaceView (pro 360° video). Doporučenou variantou je SurfaceView, protože poskytuje hardwarovou akceleraci a minimální spotřebu energie. Pro Jetpack Compose poskytuje knihovna AndroidX Media3 komponentu `AndroidView`, která obaluje SurfaceView, a experimentální `Media3Compose` s nativní integrací Compose.

Možnosti ExoPlayer

ExoPlayer nabízí širokou škálu funkcí, které přesahují běžný multimediální přehrávač. Hlavní možnosti zahrnují podporu všech populárních streamovacích protokolů, flexibilní DRM systém, adaptivní přepínání bitrate (ABR) a nástroje pro analýzu přehrávání.

Adaptivní přepínání bitrate

ABR (Adaptive Bitrate) v ExoPlayer je implementován prostřednictvím rozhraní AdaptiveTrackSelection. Ve výchozím nastavení se používá AdaptiveTrackSelectionFactory, která vytváří DefaultAdaptiveTrackSelection — vyvážený algoritmus zohledňující šířku pásma sítě a velikost vyrovnávací paměti. Pro specifické scénáře lze připojit alternativní implementace: BOLA (minimalizace přepínání), RandomAdaptiveTrackSelection (testování) nebo vlastní implementace prostřednictvím rozhraní TrackSelection.

BandwidthMeter je další klíčová komponenta odpovědná za měření šířky pásma sítě. Ve výchozím nastavení se používá DefaultBandwidthMeter, který shromažďuje statistiky ze všech HTTP požadavků přehrávače. Vývojář jej může rozšířit, aby zohlednil další faktory: typ sítě (Wi-Fi, 4G, 5G), signál mobilní věže nebo náklady na provoz pro uživatele.

DRM a ochrana obsahu

ExoPlayer podporuje Widevine (L1, L3), PlayReady a ClearKey DRM. Získání licence se konfiguruje prostřednictvím DrmSessionManager, který komunikuje s licenčním serverem. Pro prémiové video (4K HDR) je vyžadována hardwarová podpora Widevine L1, která poskytuje ochranu na úrovni čipu a zabraňuje snímání obrazovky. Výběr DRM systému závisí na cílové platformě: Widevine se používá na Android a Chromecast, PlayReady na Xbox a Windows, FairPlay na iOS a Apple TV. ExoPlayer automaticky určuje dostupný DRM systém na základě souboru MPD a nevyžaduje ruční konfiguraci pro základní scénáře.

Jak integrovat ExoPlayer do Android projektu

Připojení ExoPlayer k Android projektu se provádí pomocí závislostí Gradle. Od verze 2.19 je ExoPlayer součástí AndroidX Media (androidx.media3), což zajišťuje kompatibilitu s Jetpack Compose a dalšími komponentami AndroidX. Podívejme se na integraci krok za krokem v Kotlin.

Přidání závislostí

Přidejte moduly ExoPlayer do souboru build.gradle (Module). Minimální sada zahrnuje core, ui a modul pro požadovaný streamovací protokol. Pro přehrávání obsahu DASH je vyžadován exoplayer-dash, pro 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"
}

Základní integrace v Activity

Vytvoření a konfigurace přehrávače v Activity nebo Fragment. ExoPlayer používá PlayerView (nebo StyledPlayerView pro přizpůsobení) k zobrazení videa a vestavěných ovládacích prvků. Minimální konfigurace zahrnuje vytvoření přehrávače pomocí ExoPlayer.Builder a předání MediaItem s URI zdroje.

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()
    }
}

Zpracování chyb a stavů

Pro produkční aplikace je nezbytné zpracování možných chyb přehrávání: síťové výpadky, nepodporované formáty, chyby DRM licencování. ExoPlayer poskytuje rozhraní Player.Listener s metodami onPlayerError, onPlaybackStateChanged a onPlayWhenReadyChanged. Doporučuje se zobrazovat uživateli informativní chybové zprávy s možností opakování.

ExoPlayer vs MediaPlayer: srovnání

Volba mezi ExoPlayer a vestavěným MediaPlayer je častá otázka při vývoji Android aplikací. MediaPlayer je součástí Android SDK od verze 1.0, zatímco ExoPlayer je knihovna vyžadující připojení přes Gradle. Podívejme se na jejich rozdíly podle klíčových kritérií.

ExoPlayer vítězí ve scénářích vyžadujících streamování (DASH, HLS), přizpůsobení UI, podporu DRM a nezávislost na verzi Android. MediaPlayer je vhodný pro jednoduché aplikace přehrávající lokální multimediální soubory, kde je velikost APK kritická a nejsou požadavky na adaptivní streamování. Pro moderní aplikace s obsahem ze sítě je ExoPlayer jasnou volbou.

Výjimka — aplikace s minimální SDK nižší než API 16 (Android 4.1), které na trhu prakticky neexistují. Pro všechny aplikace s targetSdk 33+ a minimální SDK 21+ je ExoPlayer nejen preferovaný, ale také nezbytný pro podporu moderních formátů, jako jsou AV1 a Dolby Vision prostřednictvím příslušných rozšíření.

Pokročilé nastavení ExoPlayer

Pro produkční aplikace vyžaduje základní integrace ExoPlayer často další nastavení: správu cache, optimalizaci bufferování pro mobilní sítě, integraci s analytikou a přizpůsobení výběru audio stop. Podívejme se na pokročilé scénáře použití.

Cache obsahu

CacheDataSourceFactory umožňuje ukládat stažené segmenty do místního úložiště, což šetří provoz při opakovaném sledování a zajišťuje offline přehrávání. ExoPlayer používá SimpleCache z knihovny exoplayer-cas — ukládání do mezipaměti s podporou LRU vyřazování a omezení velikosti.

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()

Zpracování přepínání sítě

V mobilních aplikacích je zpracování přepínání mezi Wi-Fi a mobilní sítí klíčové. ExoPlayer poskytuje ConnectivityManager pro sledování stavu sítě. Při ztrátě připojení se doporučuje nezastavovat přehrávač, ale přepnout jej do stavu PAUSED s uchováním pozice. Po obnovení připojení pokračujte v přehrávání s opětovným načtením segmentů.

Integrace s Jetpack Compose

Po vydání AndroidX Media3 získala knihovna experimentální podporu Jetpack Compose. Komponenta `AndroidView` obaluje SurfaceView nebo PlayerView a zajišťuje kompatibilitu s hierarchií Compose. Pro hlubší integraci se používá knihovna `androidx.media3:media3-ui-compose`, která poskytuje ovládací prvky přehrávače kompatibilní s 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 } }
    )
}