Android音视频——系统播放器介绍(三)

常用监听器

开发者可以设置一些监听器,监听MediaPlayer的状态,错误事件等等。开发者应在同一个线程中创建MediaPlayer与设置的监听器。


setOnPreparedListener(android.media.MediaPlayer.OnPreparedListener)


监听MediaPlayer准备完成。一般与prepareAsync配合使用。


setOnVideoSizeChangedListener(android.media.MediaPlayer.OnVideoSizeChangedListener)


获知video大小或video大小改变时的监听。


setOnSeekCompleteListener(android.media.MediaPlayer.OnSeekCompleteListener)


监听调整位置完成。


setOnCompletionListener(android.media.MediaPlayer.OnCompletionListener)


播放完成。


mediaPlayer.setOnCompletionListener(new MediaPlayer.OnCompletionListener() {
    @Override
    public void onCompletion(MediaPlayer mediaPlayer) {
        // 当前播放完毕
    }
});

setOnBufferingUpdateListener(android.media.MediaPlayer.OnBufferingUpdateListener)


监听缓冲进度。在播放网络音频时常用。


缓冲监听器OnBufferingUpdateListener


    mMediaPlayer.prepareAsync();
    mMediaPlayer.setOnBufferingUpdateListener(new MediaPlayer.OnBufferingUpdateListener() {
        @Override
        public void onBufferingUpdate(MediaPlayer mp, int percent) {
            // 例如在这里更新UI
        }
    });

setOnInfoListener(android.media.MediaPlayer.OnInfoListener)


监听普通信息或者警告信息。


setOnErrorListener(android.media.MediaPlayer.OnErrorListener)


监听错误信息。错误发生时,可以在这里处理错误。


mediaPlayer.setOnErrorListener(new MediaPlayer.OnErrorListener() {
    @Override
    public boolean onError(MediaPlayer mediaPlayer, int i, int i1) {
        LogUtil.e(TAG_PREFIX + " onERR i = " + i + " i1 = " + i1);
        return true; // 返回true表示在此处理错误,不会回调onCompletion
    }
});


注意onError的返回值。可以选择自己处理error。
         * @return True if the method handled the error, false if it didn't.
         * Returning false, or not having an OnErrorListener at all, will
         * cause the OnCompletionListener to be called.
         */
        boolean onError(MediaPlayer mp, int what, int extra);


倍速播放

从Android API 23 (Android M)开始,MediaPlayer支持调整播放速度。

使用的方法是setPlaybackParams,传入一个代表播放属性的类PlaybackParams。


MediaPlayer.setPlaybackParams 说明

播放速度设置在PlaybackParams对象中,再将此对象传入setPlaybackParams。


setPlaybackParams是一个native方法。

如果MediaPlayer没有准备(在prepared之前),调用此方法并不会改变MediaPlayer的状态。

在MediaPlayer成功prepare之后,如果设置的速度为0,相当于调用了pause方法;如果设置速度不为0,相当于调用了start方法。


异常情况

如果MediaPlayer没有初始化或者已经被释放,即处于Idle或End状态,调用setPlaybackParams方法会抛出IllegalStateException异常。


如果传入的PlaybackParams不被支持,则抛出IllegalArgumentException异常。


如果设置速度小于0,则抛出java.lang.IllegalArgumentException异常。


MediaPlayer.setPlaybackParams 示例

设置播放速度。先判断当前系统版本。


  private fun setPlaySpeed(speed: Float): Boolean {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
            val params: PlaybackParams = mediaPlayer.getPlaybackParams()
            params.speed = speed
            mediaPlayer.setPlaybackParams(params)
            return true
        }
        return false
    }

getPlaybackParams可以获取到MediaPlayer当前的PlaybackParams对象。

也可以给这个方法加上try catch,结合返回的boolean值判断设置速度是否成功。

 private fun setPlaySpeed(speed: Float): Boolean {
        return if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
            try {
                val params: PlaybackParams = mediaPlayer.getPlaybackParams()
                params.speed = speed
                mediaPlayer.setPlaybackParams(params)
                true
            } catch (e: java.lang.Exception) {
                Log.e(TAG, "setPlaySpeed: ", e)
                false
            }
        } else false
    }

PlaybackParams 包含的速度值

调整MediaPlayer播放速度时,我们使用了PlaybackParams对象。AudioTrack也会用到这个类。


PlaybackParams包含着播放时候的一些属性。例如speed就是播放速度。


PlaybackParams.setSpeed(float speed)#

传入速度倍率值。会标记当前设置过了速度。


fun setSpeed(speed: Float): PlaybackParams? {
        mSpeed = speed
        mSet = mSet or SET_SPEED
        return this


PlaybackParams.getSpeed()

获取已设置的速度值。如果之前没设置过速度,则抛出IllegalStateException异常。


fun getSpeed(): Float {
        check(!(mSet and SET_SPEED === 0)) { "speed not set" }
        return mSpeed
    }
上一篇:linux下shell编程基础篇二


下一篇:阿里云高级技术专家周晶:基于融合与协同的边缘云原生体系实践