Android 音视频播放:MediaPlayer 与 VideoView

前言

音视频播放是应用中一个很重要的功能。Android 提供了原生的 MediaPlayer 和 VideoView 工具,来分别完成音频、视频的播放操作。但这两者的坑很多,稍微使用不当,就会造成严重问题,比如应用崩溃、资源泄露等。

我们来了解一下 MediaPlayer 和 VideoView 的正确使用方法,再说说现代 Android 中推荐的Jetpack Media3 (ExoPlayer)。

播放音频:MediaPlayer

使用 MediaPlayer,关键在于要了解其生命周期状态机 。几乎所有与 MediaPlayer 相关的崩溃问题都是因为在错误的状态下调用了方法。

图片来自于官方文档

核心方法

MediaPlayer 类中常用的控制方法:

方法名 功能描述
setDataSource() 状态: Idle -\> Initialized 设置媒体源。可以是一个路径、URI或文件描述符。
prepare() 状态: Initialized -\> Prepared 同步准备媒体。会阻塞UI线程,请谨慎使用
prepareAsync() 状态: Initialized -\> Preparing -\> Prepared (生产级推荐) 异步准备媒体,通过监听器回调来通知完成。
start() 状态: Prepared/Paused/PlaybackCompleted -\> Started 开始或恢复播放。
pause() 状态: Started -\> Paused 暂停播放。
seekTo(int msec) 定位到指定的毫秒位置。此方法不改变状态。
stop() 状态: Started/Paused/Prepared/PlaybackCompleted -\> Stopped 停止播放。
reset() 状态: 任意 -\> Idle 将播放器重置到空闲状态。
release() 状态: 任意 -\> End (必须调用) 释放所有占用的资源,调用后对象就不可以再使用。
isPlaying() 判断是否正在播放。在非法状态(如End)下调用会抛出异常。
getDuration() 获取媒体总时长。必须在 Prepared 状态之后调用。

我们来说说 MediaPlayer 的标准工作流程:

首先,获取一个 MediaPlayer 实例,然后调用其 setDataSource() 方法设置音频文件的路径。接着,调用 prepareAsync() 方法进行异步准备,防止主线程卡顿。并且进行异步准备,需要设置 setOnPreparedListener 监听器来获取准备完成的通知。

最后,当播放器准备完成后,调用 start() 方法开始播放。在播放过程中,可以调用 pause() 方法暂停,调用 start 方法恢复。如果要完全停止播放,可以使用 stop() 方法。调用后播放器会进入 Stopped 状态,需要重新准备才能再次播放。

案例:简易音乐播放器

我们通过一个案例来演示一下。

首先,创建名为 PlayAudioTest 的 Empty Views Activity 项目。在其布局中,添加三个按钮,分别对应播放、暂停以及停止操作。

activity_main.xml 中的代码如下所示:

xml 复制代码
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

    <Button
        android:id="@+id/play"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="Play" />

    <Button
        android:id="@+id/pause"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="Pause" />

    <Button
        android:id="@+id/stop"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="Stop" />
</LinearLayout>

MediaPlayer 可播放网络、本地和应用程序安装包中的音频,这里为了简单起见,我们来播放应用程序安装包中的音频。

我们将准备好的音频文件放到 app/src/main/assets 目录下,因为这个目录会在项目打包时被一并打包到安装文件中。

资源下载 密码:snow

在 MainActivity 中,按照上述流程来完成音乐播放器的逻辑。代码如下:

kotlin 复制代码
class MainActivity : AppCompatActivity() {

    private lateinit var binding: ActivityMainBinding
    private var mediaPlayer: MediaPlayer? = null
    private var isPrepared = false // 是否准备完成

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        binding = ActivityMainBinding.inflate(layoutInflater)
        setContentView(binding.root)

        // 初始化媒体播放器
        initMediaPlayer()

        binding.play.setOnClickListener {
            if (isPrepared && mediaPlayer?.isPlaying == false) {
                mediaPlayer?.start()
            }
        }

        binding.pause.setOnClickListener {
            if (mediaPlayer?.isPlaying == true) {
                mediaPlayer?.pause()
            }
        }

        binding.stop.setOnClickListener {
            if (mediaPlayer?.isPlaying == true || isPrepared) {
                mediaPlayer?.stop()
                // 此时播放器进入Stopped状态,需要重新准备
                isPrepared = false
                mediaPlayer?.prepareAsync()
            }
        }
    }

    private fun initMediaPlayer() {
        try {
            mediaPlayer = MediaPlayer()
            // 获取 AssetManager 实例,用于读取assets目录下的资源
            val assetManager = assets
            // 打开
            val fd = assetManager.openFd("music.mp3")
            // 设置数据源
            mediaPlayer?.setDataSource(fd.fileDescriptor, fd.startOffset, fd.length)

            // 使用异步准备,避免阻塞UI
            mediaPlayer?.prepareAsync()

            // 设置监听器以获取播放器准备完成的回调
            mediaPlayer?.setOnPreparedListener {
                Log.d("MediaPlayer", "Prepared!")
                isPrepared = true
            }
            // 获取播放器播放完成的回调
            mediaPlayer?.setOnCompletionListener {
                Toast.makeText(this, "播放完毕", Toast.LENGTH_SHORT).show()
                // 播放完成后,直接移到开头并暂停
                it.seekTo(0)
                it.pause()
            }
            // 获取播放器错误的回调
            mediaPlayer?.setOnErrorListener { mp, what, extra ->
                Log.e("MediaPlayer", "发生错误: what=$what, extra=$extra")
                isPrepared = false
                // 发生错误时,释放资源
                mp.release()
                mediaPlayer = null
                true // 表示已处理错误
            }
        } catch (e: IOException) {
            Log.e("MediaPlayer", "设置数据源失败", e)
        }
    }

    override fun onDestroy() {
        super.onDestroy()
        // 必须释放资源,防止内存泄漏
        mediaPlayer?.release()
        mediaPlayer = null
    }
}

现在运行程序,点击播放按钮即可开始播放音乐。点击暂停按钮就会停止,再次点击播放按钮,会在之前暂停的位置接着播放。如果此时点击了停止按钮,会停止播放,但当再次播放音乐时,音乐会重新开始播放。

播放视频:VideoView

VideoView 是一个 UI 控件,它内部封装了 MediaPlayer,可以完成视频的播放。

核心方法

VideoView 中的常用控制方法:

方法名 功能描述
setVideoPath(String path) 设置本地视频文件的路径。
setVideoURI(Uri uri) 设置视频源的 URI,可用于本地 (android.resource://) 和网络视频。
start() / pause() 开始/暂停播放。
seekTo(int msec) 将播放头移动到指定的毫秒位置。
stopPlayback() 停止播放并释放资源。
suspend() 临时释放播放器资源。
resume() 从暂停的位置恢复播放。

案例:简易视频播放器

同样地,通过一个例子来理解。

新建名为 PlayVideoTest 的 Empty Views Activity 项目。其布局中也是添加三个按钮,分别表示播放、暂停和重新播放,另外放置一个 VideoView 控件,用于显示视频。

activity_main.xml 中的代码如下所示:

xml 复制代码
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content">

        <Button
            android:id="@+id/play"
            android:layout_width="0dp"
            android:layout_height="wrap_content"
            android:layout_weight="1"
            android:text="Play" />

        <Button
            android:id="@+id/pause"
            android:layout_width="0dp"
            android:layout_height="wrap_content"
            android:layout_weight="1"
            android:text="Pause" />

        <Button
            android:id="@+id/replay"
            android:layout_width="0dp"
            android:layout_height="wrap_content"
            android:layout_weight="1"
            android:text="Replay" />
    </LinearLayout>

    <VideoView
        android:id="@+id/videoView"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />
</LinearLayout>

我们将准备好的视频文件(video.mp4)放在 res/raw 目录下。你可能会问:为什么不放在刚刚的 asserts 目录下呢?

因为 res/raw 目录下的资源可以通过 android.resource:// 协议生成对一个对应的 Uri,让 VideoView 进行播放。而 asserts 目录下的文件没有这样的 Uri,播放起来比较复杂。

资源下载 密码:snow

MainActivity 中的代码:

kotlin 复制代码
class MainActivity : AppCompatActivity() {
    private lateinit var binding: ActivityMainBinding

    private val videoView get() = binding.videoView

    // 将视频资源解析成 Uri 对象
    private val videoUri by lazy { Uri.parse("android.resource://$packageName/${R.raw.video}") }


    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        binding = ActivityMainBinding.inflate(layoutInflater)
        setContentView(binding.root)

        // 设置 Uri
        videoView.setVideoURI(videoUri)

        // 设置准备完成的监听器
        videoView.setOnPreparedListener { mediaPlayer ->
            // mediaPlayer 是 VideoView 内部的 MediaPlayer 实例
            Log.d("VideoView", "Prepared!")
        }

        // 设置错误监听器
        videoView.setOnErrorListener { _, what, extra ->
            Toast.makeText(this, "播放出错,错误码: what=$what, extra=$extra", Toast.LENGTH_LONG)
                .show()
            Log.e("VideoView", "Error: what=$what, extra=$extra")
            true // 返回 true 表示我们已经处理了该错误
        }

        // 设置播放完成监听器
        videoView.setOnCompletionListener {
            Toast.makeText(this, "播放完毕", Toast.LENGTH_SHORT).show()
        }

        binding.play.setOnClickListener {
            if (!videoView.isPlaying) {
                videoView.start()
            }
        }

        binding.pause.setOnClickListener {
            if (videoView.isPlaying) {
                videoView.pause()
            }
        }

        binding.replay.setOnClickListener {
            // 停止当前播放并释放内部播放器
            videoView.stopPlayback()

            // 重新设置视频 URI,创建新的 MediaPlayer 实例
            videoView.setVideoURI(videoUri)

            // 开始播放
            videoView.start()
        }
    }

    override fun onDestroy() {
        super.onDestroy()
        // 停止播放并释放资源
        videoView.stopPlayback()
    }
}

现在运行程序,并点击播放按钮,就可以看到视频开始播放了。

VideoView 只是一个简单的视频播放工具类,并不能支持很多视频格式,以及视频播放效率较低。但你只是使用它来播放一些简单的视频,用它还是可以的。

使用 ExoPlayer

现在,谷歌推荐使用 ExoPlayer 作为音视频播放器,因为它支持的流媒体协议更多、易于扩展和定制、API 设计更可靠。对于大多数场景,应该优先使用它。

相关推荐
FungLeo2 小时前
FengCMS · PHP+MySQL 升级实录 · 危险默认值之殇:root/123456、认证码 8888 写进配置加载器
android·mysql·php·安全加固·fengcms
yz_aiks3 小时前
Termux 使用教程:把安卓手机变成随身 Linux(装 Python、SSH 远程、跑自动化脚本)
android·linux·python·智能手机·ssh·termux
booboosui11 小时前
编号没变,消息还是来了:Mac 端通知读取漏第二条的原因
android
雨白1 天前
单例设计模式:从 Java/Kotlin 实现到 Android 实战
android
hai_android1 天前
一行 asLiveData,背后是一座生命周期的桥
android·java·kotlin
阿杰m1 天前
Android源码第二十三章:Telephony、RIL 与 IMS——来电怎么到应用?
android
booboosui1 天前
没人认领 .md:安卓把报告交给了音乐播放器打开
android
用户60709759149061 天前
AOSP 14 OTA 升级指导(四):update_engine 内部机制——Action 流水线与写盘
android
恋猫de小郭2 天前
Jetpack Compose 1.13 发布,憋了这么久终有交代了
android·前端·flutter
JMchen1232 天前
【Android 性能优化实战 60 讲】12 异步 Inflate 实战与痛击:源码拆解原生瓶颈,手写增强版布局预加载框架
android·性能优化·实战·启动优化·异步inflate·x2c