Android Media3 ExoPlayer 开发全攻略：从基础集成到高级功能实战

dependencies {
    //这里版本过高需要升级 SDK 至34 ，JDK 要 17
    def media3_version = "1.2.0"
    
    // 核心库
    implementation "androidx.media3:media3-exoplayer:$media3_version"
    // UI 组件
    implementation "androidx.media3:media3-ui:$media3_version"
    // 可选 DASH 支持
    implementation "androidx.media3:media3-exoplayer-dash:$media3_version"
    // 可选 HLS 支持
    implementation "androidx.media3:media3-exoplayer-hls:$media3_version"
    // 可选，支持 RTSP
    implementation 'androidx.media3:media3-exoplayer-rtsp:$media3_versio' 
}

这里版本过高需要升级 SDK 至34 ，JDK 要 17，否则会报如下错误：

Dependency 'androidx.media3:media3-ui:1.2.0' requires libraries and applications that
depend on it to compile against version 34 or later of the Android APIs.

如果不想使用高版本可以使用1.0.0。

3. 初始化ExoPlayer并播放视频

使用ExoPlayer播放视频需要以下几个关键步骤：

初始化播放器
加载新闻
绑定到PlayerView
控制播放

3.1 XML 布局

在activity_main.xml 参数PlayerView：

    <androidx.media3.ui.PlayerView
        android:id="@+id/playerView"
        app:resize_mode="zoom"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>

3.2 初始化ExoPlayer

在MainActivity.kt（或MainActivity.java）中创建ExoPlayer并加载视频：

class ExoPlayerActivity : BaseActivity<ActivityExoplayerBinding>() {

    private var player: ExoPlayer? = null;
    override fun getLayoutID(): Int {
        return R.layout.activity_exoplayer
    }

    override fun init() {
        initExoPlayer()
    }

    private fun initExoPlayer() {
        player = ExoPlayer.Builder(this).build().also { exoPlayer ->
            mBind.playerView.player = exoPlayer
            //加载 raw 资源，网络资源替换Uri即可。
            val mediaItem: MediaItem = MediaItem.fromUri("android.resource://" + packageName + "/" + R.raw.sv_ad_video)
            exoPlayer.setMediaItem(mediaItem)
            exoPlayer.prepare()
            exoPlayer.playWhenReady = true

        }
    }

    override fun onDestroy() {
        super.onDestroy()
        // 确保在Activity销毁时释放播放器资源
        player?.release()
        player = null
    }
}

4. 控制播放

ExoPlayer 提供了一系列方法来控制播放状态：

player?.play()         // 播放
player?.pause()        // 暂停
player?.seekTo(20000)  // 跳转到 20 秒
player?.stop()         // 停止
player?.release()      // 释放资源

5. 监听播放状态

您可以监听ExoPlayer播放状态，如播放错误、缓冲状态等：

        player?.addListener(object : Player.Listener {
            override fun onPlaybackStateChanged(state: Int) {
                when (state) {
                    ExoPlayer.STATE_READY -> {
                        println("播放器已准备好")
                    }
                    ExoPlayer.STATE_BUFFERING -> {
                        println("正在缓冲")
                    }
                    ExoPlayer.STATE_ENDED -> {
                        println("播放完成")
                    }
                }
            }

            override fun onPlayerError(error: PlaybackException) {
                println("播放错误: ${error.message}")
            }
        })

6. 播放网络流（HLS / DASH / RTSP）

ExoPlayer 支持 HTTP Live Streaming (HLS) 和 DASH 等流媒体格式。只需更改MediaItem即可：

// HLS 直播流
val mediaItem = MediaItem.fromUri("https://www.example.com/sample.m3u8") 
player?.setMediaItem(mediaItem)
player?.prepare()
player?.play()

7. ExoPlayer 进阶

7.1 手动切换功能

如果视频流支持多种权限，可以手动选择播放质量：

val trackSelector = DefaultTrackSelector(this).apply {
    parameters = buildUponParameters().setMaxVideoSizeSd().build()
}
player = ExoPlayer.Builder(this).setTrackSelector(trackSelector).build()

7.2 DRM 保护

ExoPlayer也支持DRM（如Widevine），您可以这样加载受DRM保护的内容：

val drmSessionManager = DefaultDrmSessionManager.Builder()
    .setKeyRequestParameters(mapOf("Content-Type" to "application/json"))
    .build()
val mediaItem = MediaItem.Builder()
    .setUri(videoUri)
    .setDrmUuid(C.WIDEVINE_UUID)
    .setDrmSessionManager(drmSessionManager)
    .build()
player?.setMediaItem(mediaItem)

8. 释放播放器资源

当Activity或Fragment关闭时，需要释放ExoPlayer，避免内存泄漏：

    override fun onDestroy() {
        super.onDestroy()
        // 确保在Activity/Fragment销毁时释放播放器资源
        player?.release()
        player = null
    }

内存管理：

在 onPause() 时暂停播放
在 onStop() 时释放播放器资源
使用 Player.STATE_IDLE 检测非常规状态

9. 从旧版迁移指南

主要变化点：

旧版 (com.google.android.exoplayer)	新版 (androidx.media3)
SimpleExoPlayer	ExoPlayer
DefaultTrackSelector	保持不变
PlayerView	PlayerView
MediaSource	MediaItem

10. 总结

功能	代码示例
初始化播放器	`ExoPlayer.Builder(this).build()`
播放本地视频	`MediaItem.fromUri("file:///path/to/video.mp4")`
播放网络文学	`MediaItem.fromUri("https://www.example.com/sample.m3u8")`
监听播放状态	`player.addListener(Player.Listener { ... })`
自定义 UI	`PlayerControlView`
手动切换	`DefaultTrackSelector()`
DRM 支持	`setDrmUuid(C.WIDEVINE_UUID)`
下载资源	`player.release()`