【Android】 从头搭建视频播放器(2)——SystemMediaPlayerImpl

转载请注明出处http://www.jianshu.com/p/fc07935a0b04

项目代码地址:https://github.com/Android-Jungle/android-jungle-mediaplayer
 

1、MediaPlayer 简介

        首先,我们基于系统的 android.media.MediaPlayer 实现我们的 BaseMediaPlayer。当然,我们也可以使用其他第三方的 Player 来实现,具体就在实际使用中按需求来做。

        那么,我们需要先对 MediaPlayer 做一些必要的了解。通过网上的资料搜索,我认为这篇文章对 MediaPlayer 的各种状态迁移和使用规范做了较好的阐述:

[译]class android.media.MediaPlayer

        我从这篇文章里面借了一张图如下:

状态迁移图

        通过对上图的理解,结合播放器的功能特性,抽离出了主要的状态迁移如下:

状态梳理图

        我们着重需要关注的方法列表如下:

方法 特性
new MediaPlayer()创建一个 MediaPlayer,处于 Idle 状态
reset() 重置 MediaPlayer,使其切换到 Idle 状态
setDataSource(context, uri) 设置视频数据源,切换到 Initialized 状态
prepare() 准备数据,同步方法,完成后将切换到 Prepared 状态
prepareAsync() 异步准备数据,处于 Preparing 状态,准备完毕后通过回调 OnPreparedListener.onPrepared 方法,处于 Prepared 状态
start() 开始/恢复播放,切换到 Started 状态
seekTo(millSeconds) 跳转进度
pause() 暂停播放,切换到 Paused 状态
stop() 停止播放,切换到 Stopped 状态
release() 释放播放器资源,切换到终止 End 状态,这时候不允许对 MediaPlayer 做任何操作了
setDisplay(surfaceHolder) 设置画面展示 SurfaceHolder

2、关注的回调

         MediaPlayer 有众多回调 Listener,我们需要着重关注:

回调 特性
MediaPlayer.OnPreparedListener 视频通过 prepareAsync 异步准备好之后回调
MediaPlayer.OnCompletionListener 视频播放完成后的回调
MediaPlayer.OnVideoSizeChangedListener 视频画面大小更改的回调,我们一般通过这个回调更改 SurfaceView 的大小及位置,以达到等比例缩放播放的效果
MediaPlayer.OnBufferingUpdateListener 视频缓冲进度更改回调,一般我们通过这个回调更改 SeekBar 的 SecondaryProgress
MediaPlayer.OnErrorListener 播放器内部发生错误回调,一般是错误的调用或者其他错误引起

3、使用 MediaPlayer 必需的步骤

        接下来我们基于系统的 MediaPlayer 实现 SystemMediaPlayerImpl,它继承自 BaseMediaPlayer。一般使用 MediaPlayer 有如下步骤:

步骤 内容
初始化 new MediaPlayer
设置一系列 Listener OnPreparedListener 等等
设置数据源 setDataSource. 可以是本地文件,也可以是网络数据 Url
处理 OnPreparedListener.onPrepared 回调 设置画面展示 SurfaceHolder,并调用 start 开始播放。如果需要从视频的某个位置播放,可在这里调用 seekTo(millSeconds) 直接跳转
处理 OnVideoSizeChangedListener.onVideoSizeChanged 回调 在此通过获取到的视频画面大小调整 SurfaceView 的位置及大小,达到等比例缩放的效果
处理 OnBufferingUpdateListener.onBufferingUpdate 回调 再次可以更新界面上的进度条的缓冲进度
处理 OnCompletionListener.onCompletion 回调 在此处理播放完成通知,可以按需求来做按章节连续播放或者退出页面等等上层业务逻辑
处理 OnErrorListener.onError 回调 处理错误,进行 UI 的展示更新等等

4、SystemMediaPlayerImpl

        我们根据上面的步骤,结合 上一篇文章 中介绍的 BaseMediaPlayer,实现出 SystemMediaPlayerImpl 如下:

/**
 * SystemMediaPlayerImpl.java
 *
 * @author arnozhang
 * @email  zyfgood12@163.com
 * @date   2015.9.25
 */
public class SystemMediaPlayerImpl extends BaseMediaPlayer {

    private MediaPlayer mMediaPlayer;


    public SystemMediaPlayerImpl(Context context, SurfaceView surfaceView) {
        super(context, surfaceView);

        init();
    }

    private void init() {
        mMediaPlayer = new MediaPlayer();
        mMediaPlayer.setAudioStreamType(AudioManager.STREAM_MUSIC);
        mMediaPlayer.setOnPreparedListener(onPreparedListener);
        mMediaPlayer.setOnVideoSizeChangedListener(mOnVideoSizeChangedListener);
        mMediaPlayer.setOnBufferingUpdateListener(mOnBufferingUpdateListener);
        mMediaPlayer.setOnErrorListener(mOnErrorListener);
        mMediaPlayer.setOnCompletionListener(mOnCompletionListener);
    }

    @Override
    public void play(VideoInfo videoInfo) {
        if (mMediaPlayer == null) {
            return;
        }

        super.play(videoInfo);

        // Clear old display and Reset.
        mMediaPlayer.setDisplay(null);
        mMediaPlayer.reset();

        try {
            mMediaPlayer.setDataSource(mContext, Uri.parse(videoInfo.getCurrentStreamUrl()));
        } catch (IOException e) {
            e.printStackTrace();
        }

        // Prepare For Play.
        mMediaPlayer.prepareAsync();
        notifyStartPlay();
        notifyLoading();
    }

    @Override
    public void pause() {
        if (mMediaPlayer == null || !mMediaPlayerIsPrepared) {
            return;
        }

        if (mMediaPlayer.isPlaying()) {
            mMediaPlayer.pause();
            notifyPaused();
        }
    }

    @Override
    public void resume() {
        if (mMediaPlayer == null || !mMediaPlayerIsPrepared) {
            return;
        }

        mMediaPlayer.start();
        notifyResumed();
    }

    @Override
    public void stop() {
        if (mMediaPlayer == null) {
            return;
        }

        if (mMediaPlayer.isPlaying()) {
            mMediaPlayer.stop();
        }

        notifyStopped();
    }

    @Override
    public void seekTo(int millSeconds) {
        if (mMediaPlayer != null) {
            mMediaPlayer.seekTo(millSeconds);
        }
    }

    @Override
    public void setVolume(float volume) {
        if (mMediaPlayer != null) {
            mMediaPlayer.setVolume(volume, volume);
        }
    }

    @Override
    public int getDuration() {
        return mMediaPlayer != null ? mMediaPlayer.getDuration() : 0;
    }

    @Override
    public int getCurrentPosition() {
        return mMediaPlayer != null ? mMediaPlayer.getCurrentPosition() : 0;
    }

    @Override
    public void doDestroy() {
        clearLoadingFailed();
        mMediaPlayer.release();
        mMediaPlayer = null;
    }

    @Override
    public boolean isPlaying() {
        return mMediaPlayer != null && mMediaPlayer.isPlaying();
    }

    @Override
    protected void playWithDisplayHolder(SurfaceHolder holder) {
        mMediaPlayer.setDisplay(holder);
        mMediaPlayer.setScreenOnWhilePlaying(true);
        mMediaPlayer.start();
        mMediaPlayer.seekTo(0);

        trySeekToStartPosition();
    }

    private void clearLoadingFailed() {
        ThreadManager.getInstance().getUIHandler().removeCallbacks(mLoadingFailedRunnable);
    }

    MediaPlayer.OnPreparedListener onPreparedListener = new MediaPlayer.OnPreparedListener() {
        public void onPrepared(MediaPlayer player) {
            mAutoPlayWhenHolderCreated = false;
            mMediaPlayerIsPrepared = true;
            mIsLoading = false;

            clearLoadingFailed();
            notifyFinishLoading();

            // Start Play.
            SurfaceHolder holder = mSurfaceView.getHolder();
            if (holder == null) {
                mAutoPlayWhenHolderCreated = true;
            } else {
                playWithDisplayHolder(holder);
            }
        }
    };

    private void trySeekToStartPosition() {
        int seekToPosition = mVideoInfo.getCurrentPosition();
        if (mMediaPlayer != null && mMediaPlayerIsPrepared && mVideoSizeInitialized && seekToPosition > 0) {
            mMediaPlayer.seekTo(seekToPosition);
        }
    }

    MediaPlayer.OnCompletionListener mOnCompletionListener =
            new MediaPlayer.OnCompletionListener() {
                public void onCompletion(MediaPlayer player) {
                    player.seekTo(0);
                    notifyPlayComplete();
                }
            };

    MediaPlayer.OnVideoSizeChangedListener mOnVideoSizeChangedListener =
            new MediaPlayer.OnVideoSizeChangedListener() {
                public void onVideoSizeChanged(MediaPlayer player, int width, int height) {
                    mVideoWidth = player.getVideoWidth();
                    mVideoHeight = player.getVideoHeight();

                    updateSurfaceSize();

                    mVideoSizeInitialized = true;
                    trySeekToStartPosition();
                }
            };

    MediaPlayer.OnBufferingUpdateListener mOnBufferingUpdateListener =
            new MediaPlayer.OnBufferingUpdateListener() {
                public void onBufferingUpdate(MediaPlayer player, int percent) {
                    mBufferPercent = percent;
                }
            };

    MediaPlayer.OnErrorListener mOnErrorListener = new MediaPlayer.OnErrorListener() {
        public boolean onError(MediaPlayer player, int what, int extra) {
            String errorWhat;
            switch (what) {
                case 1:
                    errorWhat = "MEDIA_ERROR_UNKNOWN";
                    break;
                case 100:
                    errorWhat = "MEDIA_ERROR_SERVER_DIED";
                    break;
                default:
                    errorWhat = "!";
            }

            String errorExtra;
            switch (extra) {
                case -1010:
                    errorExtra = "MEDIA_ERROR_UNSUPPORTED";
                    break;
                case -1007:
                    errorExtra = "MEDIA_ERROR_MALFORMED";
                    break;
                case -1004:
                    errorExtra = "MEDIA_ERROR_IO";
                    break;
                case -110:
                    errorExtra = "MEDIA_ERROR_TIMED_OUT";
                    break;
                default:
                    errorExtra = "!";
            }

            String msg = String.format("what:%#x,%s extra:%#x,%s", what, errorWhat, extra, errorExtra);
            notifyError(what, msg);
            return true;
        }
    };
}

        下一篇我们将介绍手势检测与控制。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,547评论 6 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,399评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,428评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,599评论 1 274
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,612评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,577评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,941评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,603评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,852评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,605评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,693评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,375评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,955评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,936评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,172评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 43,970评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,414评论 2 342

推荐阅读更多精彩内容