ExoPlayer：是什么、功能与配置

什么是ExoPlayer？

ExoPlayer是一个用于Android的多媒体播放库，采用开源代码（Apache 2.0），其第一个版本于2014年由Google发布。与内置的MediaPlayer（它是系统媒体编解码器MediaCodec之上的一个薄层）不同，ExoPlayer完全在Java/Kotlin级别实现，使开发人员能够完全控制播放的每个阶段。

在架构上，ExoPlayer建立在模块化原则之上：播放的每个方面都由单独的组件实现。主模块（exoplayer-core）包含播放器、渲染器、轨道选择器和缓冲区管理。附加模块（exoplayer-dash、exoplayer-hls、exoplayer-rtsp、exoplayer-smoothstreaming）增加了对相应流媒体协议的支持。这种架构允许应用程序只连接必要的组件，从而最大限度地减少APK大小。

ExoPlayer 2（当前主版本）于2018年发布，带来了API的重大改造：引入Player Interface、通过AndroidX Media3支持Compose、改进的错误处理和自适应轨道选择算法。从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系统、自适应比特率切换（ABR）和播放分析工具。

自适应比特率切换

ABR（自适应比特率）在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根据MPD文件自动确定可用的DRM系统，并且基本场景不需要手动配置。

如何将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创建播放器并传递带有源URI的MediaItem。

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 vs MediaPlayer：比较

在ExoPlayer和内置MediaPlayer之间进行选择是Android应用开发中的常见问题。MediaPlayer从1.0版本开始就是Android SDK的一部分，而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使用来自exoplayer-cas库的SimpleCache——支持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 } }
    )
}