1. ExoPlayer 架构全景：核心组件、层级关系、播放管线、事件回调、线程模型

在开始自定义边界之前，必须理解 ExoPlayer 的整体架构。ExoPlayer 是一个模块化、可扩展的 Android 媒体播放器，其架构围绕 Player 接口、MediaSource 数据源、Renderer 渲染器、TrackSelector 轨道选择器、LoadControl 加载控制器等核心组件构建。以下内联 SVG 展示了各组件之间的层级关系与调用流程。

1.1 核心组件职责

ExoPlayer.Builder(context).build()

1.2 播放管线与事件回调

播放管线执行顺序：prepare → load (数据加载 & 解码) → render → output。各阶段通过 Player.Listener 或 AnalyticsListener 回调对外暴露状态变化。关键事件包括：

• onPlayerStateChanged(playWhenReady, playbackState) — 状态切换（IDLE、BUFFERING、READY、ENDED）
• onIsPlayingChanged(isPlaying) — 实际播放进度推进
• onPlayerError(error) — 播放失败（网络异常、解码器不支持等）
• onRenderedFirstFrame() — 第一帧渲染（可用于封面切换）

1.3 线程模型深度说明

ExoPlayer 内部使用多个线程协同工作，理解线程模型对避免死锁、ANR 至关重要：

• 主线程（UI 线程）：所有 Player 方法调用（如 play()、seekTo()）必须在此线程执行；回调也由此线程分发。
• 内部播放线程：驱动 Pipeline 循环，负责从 MediaSource 拉取数据、调用 Renderer 解码、控制进度；此线程运行在 HandlerThread 中。
• 解码器线程：MediaCodec 异步输入/输出回调，在解码器内部线程池中执行。
• 网络线程：DataSource 实现（如 HttpDataSource）在后台线程池中执行 HTTP 请求。

1.4 基础实现流程与示例

下面是最小可运行播放器的构建步骤：

1. 创建 Player 实例（使用 Builder）
2. 构建 MediaSource（以本地视频文件为例）
3. 设置播放器监听器捕获状态
4. 调用 player.setMediaSource() 和 player.prepare()
5. 调用 player.play()
6. 在 Activity/Fragment 生命周期中释放

// Kotlin 示例：最小播放器
val context = this
val player = ExoPlayer.Builder(context).build()

// 构建 MediaSource (HLS 示例)
val uri = Uri.parse("https://example.com/stream.m3u8")
val mediaSource = HlsMediaSource.Factory(
    DefaultHttpDataSource.Factory()
).createMediaSource(mediaItem)

// 设置监听器
player.addListener(object : Player.Listener {
    override fun onPlaybackStateChanged(state: Int) {
        when (state) {
            Player.STATE_READY -> Log.d("Demo", "播放就绪")
            Player.STATE_BUFFERING -> Log.d("Demo", "缓冲中")
            Player.STATE_ENDED -> Log.d("Demo", "播放结束")
        }
    }
    override fun onPlayerError(error: PlaybackException) {
        Log.e("Demo", "播放异常: ${error.message}")
    }
})

player.setMediaSource(mediaSource)
player.prepare()
player.playWhenReady = true  // 开始播放

// 释放
override fun onDestroy() {
    super.onDestroy()
    player.release()
}

1.5 常见错误与调试技巧