写点什么

Android MediaPlayer 音频播放器详解

作者:yechaoa
  • 2022 年 6 月 19 日
  • 本文字数:3648 字

    阅读完需:约 12 分钟

效果


音频播放,是比较常见或常用的功能,比如音乐播放器新闻播报听书等等,而恰巧如果你想自定义一个音频播放器的话,本文一定对你有帮助!

常用方法

  • start() 开始播放

  • pause() 暂停播放

  • stop() 停止播放

  • prepare() 资源准备

  • prepareAsync() 异步准备,不阻塞 UI 线程

  • seekTo(int msec) 定位到指定位置,单位毫秒

  • isLooping 是否循环播放

  • isPlaying 播放状态

  • duration 总时长

  • currentPosition 当前位置

  • release() 资源释放

Component Tree

具体的xml代码就不贴了,看一下组件树


初始化

    /**     * 初始化 及 资源准备     */    private fun audioPrepare(path: String) {         mMediaPlayer = MediaPlayer().apply {            setDataSource(path)//支持文件、网络地址、uri            prepareAsync()//异步准备,不阻塞UI线程            isLooping = false//循环播放        }
initMediaPlayerListener() }
复制代码


setDataSource,设置数据源,支持本地文件、网络请求的地址、uri 等,看一下源码:


  • setDataSource(FileDescriptor)

  • setDataSource(String)

  • setDataSource(Context, Uri)

  • setDataSource(FileDescriptor, long, long)

  • setDataSource(MediaDataSource)


如果是本地文件,注意读写权限。


prepareAsync() 异步准备,不阻塞 UI 线程


然后看一下调用的initMediaPlayerListener 方法

播放器监听事件及交互

    /**     * 播放器监听事件     */    private fun initMediaPlayerListener() {
mMediaPlayer?.setOnBufferingUpdateListener { mp, percent -> LogUtil.i("缓冲进度$percent%") }
mMediaPlayer?.setOnPreparedListener { LogUtil.i("准备完成") //在准备完成之后获取信息,否则会有异常 val duration = mMediaPlayer?.duration//时长 val currentPosition = mMediaPlayer?.currentPosition//当前位置 LogUtil.i("当前位置$currentPosition/时长$duration")
tv_currentPosition.text = formatDuration(currentPosition!!) tv_duration.text = formatDuration(duration!!)
seek_bar.max = duration }
mMediaPlayer?.setOnCompletionListener { LogUtil.i("播放完毕") }
mMediaPlayer?.setOnErrorListener { mp, what, extra -> LogUtil.i("播放错误") return@setOnErrorListener true }
mMediaPlayer?.setOnSeekCompleteListener { LogUtil.i("定位完成") }
seek_bar.setOnSeekBarChangeListener(object : SeekBar.OnSeekBarChangeListener { override fun onProgressChanged(seekBar: SeekBar?, progress: Int, fromUser: Boolean) { tv_currentPosition.text = formatDuration(seekBar!!.progress) }
override fun onStartTrackingTouch(seekBar: SeekBar?) { }
override fun onStopTrackingTouch(seekBar: SeekBar?) { //拖动结束之后再设置,如果在onProgressChanged中设置会有杂音 mMediaPlayer?.seekTo(seekBar!!.progress) tv_currentPosition.text = formatDuration(seekBar!!.progress) } })
btn_start.setOnClickListener { audioStart() } btn_pause.setOnClickListener { audioPause() } btn_seek.setOnClickListener { seek_bar.progress = (seek_bar.max * 0.8).roundToInt() mMediaPlayer?.seekTo(seek_bar!!.progress) tv_currentPosition.text = formatDuration(seek_bar!!.progress) audioStart() } btn_restart.setOnClickListener { audioRestart() } }
复制代码


主要 是一些播放器的监听事件和按钮操作事件。


https://blog.csdn.net/yechaoa


着重介绍两个:

1、setOnPreparedListener

注意,在获取资源时长的时候,需要在播放器准备完成之后获取,否则会有异常


Attempt to call getDuration in wrong state: mPlayer=0x7244676280, mCurrentState=4error (-38, 0)
复制代码


并会回调OnErrorListener


然后设置显示,并把时长赋值给seek_bar的最大值。

2、setOnSeekBarChangeListener

3 个方法:


  • onProgressChanged 进度改变

  • onStartTrackingTouch 开始拖动

  • onStopTrackingTouch 停止拖动


我们需要在改变中改变后对当前播放时长进行更新,并在最后的位置进行播放操作。


如果程序上没有定位到指定播放位置这种操作的话,不要在onProgressChanged 中执行播放操作,因为频繁的进度改变,频繁的调用播放,会有杂音


所以建议用户手动拖动来触发播放。


如果非要程序可以跳到指定位置播放的话,建议如下操作:


        btn_seek.setOnClickListener {            seek_bar.progress = (seek_bar.max * 0.8).roundToInt()            mMediaPlayer?.seekTo(seek_bar!!.progress)            tv_currentPosition.text = formatDuration(seek_bar!!.progress)            audioStart()        }
复制代码


手动赋值progress ,并调用播放。

格式化播放时间

这个获取时长返回的是毫秒,所以我们还需要对其格式化操作。


    /**     * 格式化播放时间     */    private fun formatDuration(duration: Int): String {        val d = duration / 1000        val minute = d / 60        val second = d % 60        val m: String = if (minute < 10) "0$minute" else "$minute"        val s: String = if (second < 10) "0$second" else "$second"        return "$m:$s"    }
复制代码


做了一个判断,不足两位数则前位补 0。

开始播放

    /**     * 开始播放     */    private fun audioStart() {        mMediaPlayer?.run {            if (!this.isPlaying) {                start()                startTimer()            }        }    }
复制代码


因为没有播放中的回调接口,所以这里启动一个Timer获取当前位置并更新UI

Timer 更新 UI

    /**     * 每隔一秒执行一次,更新当前播放时间     */    private fun startTimer() {        mTimer = Timer().apply {            schedule(object : TimerTask() {                override fun run() {                    //非ui线程不能更新view,所以这里赋值给seek_bar,在seek_bar的事件中去更新                    seek_bar.progress = mMediaPlayer!!.currentPosition                    //tv_currentPosition.text = formatDuration(mMediaPlayer!!.currentPosition)                }            }, 0, 1000)        }    }
复制代码


这里要注意,非ui线程不能更新 view,所以这里赋值给seek_bar,在 seek_bar 的 onProgressChanged 回调中去更新。

暂停播放

    /**     * 暂停播放     */    private fun audioPause() {        mMediaPlayer?.run {            if (this.isPlaying) {                pause()                cancelTimer()            }        }    }
复制代码


同样,暂停的时候取消Timer,做到资源及时回收。

取消 Timer

    private fun cancelTimer() {        mTimer?.run {            cancel()            mTimer = null        }    }
复制代码

暂停/继续 播放

    /**     * 暂停/继续 播放     */    private fun audioToggle() {        mMediaPlayer?.run {            if (this.isPlaying) {                audioPause()            } else {                audioStart()            }        }    }
复制代码


如果只有一个事件触发的话,可以这么来写。

重新播放

播放器并没有自带restart()方法,不过我们可以手动把播放位置改到初始值,并调用播放。


    /**     * 重新播放     */    private fun audioRestart() {        mMediaPlayer?.run {            //定位到指定位置,单位毫秒            seekTo(0)            audioStart()
seek_bar.progress = 0 tv_currentPosition.text = formatDuration(seek_bar!!.progress)
//如果是下一首,可以调用reset()重置,然后set新的数据源 } }
复制代码


如果是下一首,可以调用reset()重置,然后 set 新的数据源

资源回收

及时的回收,有利于更好的性能


    override fun onDestroy() {        mAgentWeb.webLifeCycle.onDestroy()        super.onDestroy()
cancelTimer()
mMediaPlayer?.run { stop() release() mMediaPlayer = null } }
复制代码


ok,到此就讲解完了。


写作不易,如果对你有用,点个赞吧 ^ - ^

发布于: 刚刚阅读数: 5
用户头像

yechaoa

关注

优质作者 2018.10.23 加入

知名互联网大厂技术专家,多平台博客专家、优秀博主、人气作者,博客风格深入浅出,专注于Android领域,同时探索于大前端方向,持续研究并落地前端、小程序、Flutter、Kotlin等相关热门技术

评论

发布
暂无评论
Android MediaPlayer音频播放器详解_android_yechaoa_InfoQ写作社区