在App开发中偶然会需求播映视频，JetPack Media3是目前官方主推的视频播映库，使用ExoPlayer作为默许播映器，让开发人员能够轻松的完成播映视频和音频功用。本文简单介绍下如何使用Media3库播映视频。

官方文档

增加依靠

在app module下的build.gradle中增加代码，如下:

dependencies {
    implementation("androidx.media3:media3-ui:1.1.0")
    implementation("androidx.media3:media3-session:1.1.0")
    implementation("androidx.media3:media3-exoplayer:1.1.0")
}

增加PlayerView

在布局文件中增加PlayerView，承载视频播映器，代码如下：

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent">
    <androidx.media3.ui.PlayerView
        android:id="@+id/play_view"
        android:layout_width="match_parent"
        android:layout_height="320dp"
        app:layout_constraintTop_toTopOf="parent"
        app:resize_mode="fill"
        app:show_buffering="always"
        app:use_controller="false" />
</androidx.constraintlayout.widget.ConstraintLayout>

一些可装备参数如下：

插图参数：

参数名 类型 补白
use_artwork boolean 是否使用插图
artwork_display_mode enum 插图显现形式（off、fit、fill）
default_artwork reference 默许插图

控制器参数：

参数名 类型 补白
use_controller boolean 是否使用控制器
hide_on_touch boolean 是否在触摸时躲藏控制器
hide_during_ads boolean 是否在广告播映期间躲藏控制器
auto_show boolean 是否主动显现控制器
show_timeout integer 显现控制器的超时时刻
show_shuffle_button boolean 是否显现随机播映按钮
show_subtitle_button boolean 是否显现字幕按钮
show_vr_button boolean 是否显现VR按钮
time_bar_min_update_interval integer 进度条的最小更新时刻间隔
animation_enabled boolean 是否启用控制器动画作用

PlayerView参数：

参数名 类型 补白
show_buffering enum 是否显现缓冲状况（never、when_playing、always）
keep_content_on_player_reset boolean 当播映器重置时，是否在其上保留媒体内容（例如字幕）
surface_type enum 视频渲染控件类型 (none、surface_view、texture_view、spherical_gl_surface_view、video_decoder_gl_surface_view)
resize_mode enum 调整视频大小的形式 （fit、fixed_width、fixed_heigt、fill、zoom）

播映视频

创立ExoPlayer装备到PlayerView中，设置好要播映的资源后就能够播映视频，代码如下：

class Media3ExampleActivity : AppCompatActivity() {
    private lateinit var binding: LayoutMedia3ExampleActivityBinding
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        binding = LayoutMedia3ExampleActivityBinding.inflate(layoutInflater)
        setContentView(binding.root)
        binding.includeTitle.tvTitle.text = "Media3 Example"
        // 创立ExoPlayer，装备到PlayerView中
        binding.playView.player = ExoPlayer.Builder(this)
            .build()
        binding.playView.player?.run {
            // 设置播映监听
            addListener(object : Player.Listener {
                override fun onIsPlayingChanged(isPlaying: Boolean) {
                    super.onIsPlayingChanged(isPlaying)
                    // 播映状况改变回调
                }
                override fun onPlaybackStateChanged(playbackState: Int) {
                    super.onPlaybackStateChanged(playbackState)
                    when (playbackState) {
                        Player.STATE_IDLE -> {
                            //播映器中止时的状况
                        }
                        Player.STATE_BUFFERING -> {
                            // 正在缓冲数据
                        }
                        Player.STATE_READY -> {
                            // 能够开端播映
                        }
                        Player.STATE_ENDED -> {
                            // 播映结束
                        }
                    }
                }
                override fun onPlayerError(error: PlaybackException) {
                    super.onPlayerError(error)
                    // 获取播映错误信息
                }
            })
            // 设置重复形式
            // Player.REPEAT_MODE_ALL 无限重复
            // Player.REPEAT_MODE_ONE 重复一次
            // Player.REPEAT_MODE_OFF 不重复
            repeatMode = Player.REPEAT_MODE_ALL
            // 设置当缓冲结束后直接播映视频
            playWhenReady = true
        }
        binding.btnPlaySingleVideo.setOnClickListener {
            binding.playView.player?.run {
                // 中止之前播映的视频
                stop()
                //设置单个资源
                setMediaItem(MediaItem.fromUri("https://minigame.vip/Uploads/images/2021/09/18/1631951892_page_img.mp4"))
                // 开端缓冲
                prepare()
            }
        }
        binding.btnPlayMultiVideo.setOnClickListener {
            binding.playView.player?.run {
                // 中止之前播映的视频
                stop()
                // 设置多个资源，当一个视频播完后主动播映下一个
                setMediaItems(arrayListOf(
                    MediaItem.fromUri("https://minigame.vip/Uploads/images/2021/09/18/1631951892_page_img.mp4"),
                    MediaItem.fromUri("https://storage.googleapis.com/exoplayer-test-media-1/mp4/dizzy-with-tx3g.mp4")
                ))
                // 开端缓冲
                prepare()
            }
        }
    }
    override fun onResume() {
        super.onResume()
        // 恢复播映
        binding.playView.onResume()
    }
    override fun onPause() {
        super.onPause()
        // 暂停播映
        binding.playView.onPause()
    }
    override fun onDestroy() {
        super.onDestroy()
        // 释放播映器资源
        binding.playView.player?.release()
        binding.playView.player = null
    }
}

作用如图：

单视频 多视频
Android Media3 （一）— 简单播放视频
Android Media3 （一）— 简单播放视频

示例

演示代码已在示例Demo中增加。

ExampleDemo github

ExampleDemo gitee