Android 超好用的播放器——ijkplayer

拼搏现实的明天。 2022-12-16 09:08 1462阅读 0赞

### 前言 ###

ijkplayer是b站开源的超级好用的视频播放器喔，相信大家都早有耳闻。ijkplayer Android和ios都可用，还支持多种视频的硬解码。人生苦短，不如快点试一试。

[ijkplayer的github地址][ijkplayer_github]

### ijkplayer的编译 ###

##### gradle #####

现在可以直接使用gradle引入ijkplayer了。但是，如果需要对更多格式进行支持，还是需要自己编译一次。

allprojects {
        repositories {
            jcenter()
        }
    }
    
    dependencies {
        # required, enough for most devices.
        compile 'tv.danmaku.ijk.media:ijkplayer-java:0.8.1.2'
        compile 'tv.danmaku.ijk.media:ijkplayer-armv7a:0.8.1.2'
    
        # Other ABIs: optional
        compile 'tv.danmaku.ijk.media:ijkplayer-armv5:0.8.1.2'
        compile 'tv.danmaku.ijk.media:ijkplayer-arm64:0.8.1.2'
        compile 'tv.danmaku.ijk.media:ijkplayer-x86:0.8.1.2'
        compile 'tv.danmaku.ijk.media:ijkplayer-x86_64:0.8.1.2'
    
        # ExoPlayer as IMediaPlayer: optional, experimental
        compile 'tv.danmaku.ijk.media:ijkplayer-exo:0.8.1.2'
    }

##### 编译 #####

如果我们需要获取更多的视频格式支持（比如mkv，rmvb等），需要自己进行编译。我这里有个成品，包括一个小的demo，不想编译的同学可以自提。[github地址][github]。

我是在Ubuntu下编译的。具体的方法官方的GitHub有，我总结一下，基本就是对着终端输入指令：

1.  自行在ubuntu下配置好Android的sdk和ndk。
2.  安装git和yasm。打开终端，依次输入如下指令：

sudo apt-get update
    sudo apt-get install git
    sudo apt-get install yasm

1.  从github中拉取代码，并且cd到代码的目录下

git clone https://github.com/Bilibili/ijkplayer.git ijkplayer-android
    cd ijkplayer-android

1.  把代码更新到最新的版本。最新的版本号可以看GitHub。输入指令：

git checkout -B latest k0.8.1.2

1.  初始化，包括了把ffmpeg的代码拉取到本地等操作，输入指令：

./init-android.sh

1.  clean一下，输入指令：

cd android/contrib
    
    ./compile-ffmpeg.sh clean

1.  编译ffmpeg软解码库，输入指令：

./compile-ffmpeg.sh all

1.  cd到上一级目录，输入指令：

cd ..

1.  得到ijkplayer的项目，输入指令：

./compile-ijk.sh all

其实就是跟着步骤在命令行中敲指令。看清楚指令，不要敲错，应该很快就可以得到我们ijkplayer的项目了。这个项目已经可以支持所有的视频格式了。

在这个项目中，有好多好多个module，有exmaple，ijkplayer-java，ijkplayer-armv5等。分别是例子，ijkplayer java层的代码，适配不同cpu的native层代码等。

### 简单的ijkplayer使用 ###

下面是我使用的方法。可以直接看这个demo：[github地址][github]。

1.  引入依赖。  
    我使用的ijkplayer的支持库，是编译得来的。所以我依赖了这些module

compile project(':ijkplayer-java')
        compile project(':ijkplayer-armv5')
        compile project(':ijkplayer-armv7a')
        compile project(':ijkplayer-arm64')
        compile project(':ijkplayer-x86')
        compile project(':ijkplayer-x86_64')

1.  自定义播放控件  
    ijkplayer提供的没有提供一个播放器控件给我们使用，所以我们自己定义一个。主要是创建一个surfaceview，把它赋给IMediaPlayer。

/**
         * 由ijkplayer提供，用于播放视频，需要给他传入一个surfaceView
         */
        private IMediaPlayer mMediaPlayer = null;
    
        /**
         * 视频文件地址
         */
        private String mPath = "";
    
        private SurfaceView surfaceView;
    
        private VideoPlayerListener listener;
        private Context mContext;
    
        public VideoPlayerIJK(@NonNull Context context) {
            super(context);
            initVideoView(context);
        }
    
        public VideoPlayerIJK(@NonNull Context context, @Nullable AttributeSet attrs) {
            super(context, attrs);
            initVideoView(context);
        }
    
        public VideoPlayerIJK(@NonNull Context context, @Nullable AttributeSet attrs, @AttrRes int defStyleAttr) {
            super(context, attrs, defStyleAttr);
            initVideoView(context);
        }
    
        private void initVideoView(Context context) {
            mContext = context;
    
            //获取焦点，不知道有没有必要~。~
            setFocusable(true);
        }
    
        /**
         * 设置视频地址。
         * 根据是否第一次播放视频，做不同的操作。
         *
         * @param path the path of the video.
         */
        public void setVideoPath(String path) {
            if (TextUtils.equals("", mPath)) {
                //如果是第一次播放视频，那就创建一个新的surfaceView
                mPath = path;
                createSurfaceView();
            } else {
                //否则就直接load
                mPath = path;
                load();
            }
        }
    
        /**
         * 新建一个surfaceview
         */
        private void createSurfaceView() {
            //生成一个新的surface view
            surfaceView = new SurfaceView(mContext);
            surfaceView.getHolder().addCallback(new LmnSurfaceCallback());
            LayoutParams layoutParams = new LayoutParams(LayoutParams.MATCH_PARENT
                    , LayoutParams.MATCH_PARENT, Gravity.CENTER);
            surfaceView.setLayoutParams(layoutParams);
            this.addView(surfaceView);
        }
    
        /**
         * surfaceView的监听器
         */
        private class LmnSurfaceCallback implements SurfaceHolder.Callback {
            @Override
            public void surfaceCreated(SurfaceHolder holder) {
            }
    
            @Override
            public void surfaceChanged(SurfaceHolder holder, int format, int width, int height) {
                //surfaceview创建成功后，加载视频
                load();
            }
    
            @Override
            public void surfaceDestroyed(SurfaceHolder holder) {
            }
        }
    
        /**
         * 加载视频
         */
        private void load() {
            //每次都要重新创建IMediaPlayer
            createPlayer();
            try {
                mMediaPlayer.setDataSource(mPath);
            } catch (IOException e) {
                e.printStackTrace();
            }
            //给mediaPlayer设置视图
            mMediaPlayer.setDisplay(surfaceView.getHolder());
    
            mMediaPlayer.prepareAsync();
        }
    
        /**
         * 创建一个新的player
         */
        private void createPlayer() {
            if (mMediaPlayer != null) {
                mMediaPlayer.stop();
                mMediaPlayer.setDisplay(null);
                mMediaPlayer.release();
            }
            IjkMediaPlayer ijkMediaPlayer = new IjkMediaPlayer();
            ijkMediaPlayer.native_setLogLevel(IjkMediaPlayer.IJK_LOG_DEBUG);
    
    //开启硬解码        ijkMediaPlayer.setOption(IjkMediaPlayer.OPT_CATEGORY_PLAYER, "mediacodec", 1);
    
            mMediaPlayer = ijkMediaPlayer;
    
            if (listener != null) {
                mMediaPlayer.setOnPreparedListener(listener);
                mMediaPlayer.setOnInfoListener(listener);
                mMediaPlayer.setOnSeekCompleteListener(listener);
                mMediaPlayer.setOnBufferingUpdateListener(listener);
                mMediaPlayer.setOnErrorListener(listener);
            }
        }
    
        public void setListener(VideoPlayerListener listener) {
            this.listener = listener;
            if (mMediaPlayer != null) {
                mMediaPlayer.setOnPreparedListener(listener);
            }
        }
    
        /**
         * -------======--------- 下面封装了一下控制视频的方法
         */
    
        public void start() {
            if (mMediaPlayer != null) {
                mMediaPlayer.start();
            }
        }
    
        public void release() {
            if (mMediaPlayer != null) {
                mMediaPlayer.reset();
                mMediaPlayer.release();
                mMediaPlayer = null;
            }
        }
    
        public void pause() {
            if (mMediaPlayer != null) {
                mMediaPlayer.pause();
            }
        }
    
        public void stop() {
            if (mMediaPlayer != null) {
                mMediaPlayer.stop();
            }
        }
    
        public void reset() {
            if (mMediaPlayer != null) {
                mMediaPlayer.reset();
            }
        }
    
        public long getDuration() {
            if (mMediaPlayer != null) {
                return mMediaPlayer.getDuration();
            } else {
                return 0;
            }
        }
    
        public long getCurrentPosition() {
            if (mMediaPlayer != null) {
                return mMediaPlayer.getCurrentPosition();
            } else {
                return 0;
            }
        }
    
        public void seekTo(long l) {
            if (mMediaPlayer != null) {
                mMediaPlayer.seekTo(l);
            }
        }
    }

我们这个控件继承自framelayout。这个控件负责存放一个surfaceView和一个IMediaPlayer 。

3，设置监听器，我自己定义了一个监听器，继承了IMediaPlayer的n个listener。

public abstract class VideoPlayerListener implements IMediaPlayer.OnBufferingUpdateListener, IMediaPlayer.OnCompletionListener, IMediaPlayer.OnPreparedListener, IMediaPlayer.OnInfoListener, IMediaPlayer.OnVideoSizeChangedListener, IMediaPlayer.OnErrorListener, IMediaPlayer.OnSeekCompleteListener {
    }

当我们继承这个抽象类的时候，最重要的是在onPrepared()方法中，让视频开始播放：

ijkPlayer.setListener(new VideoPlayerListener() {
                @Override
                public void onBufferingUpdate(IMediaPlayer mp, int percent) {
                }
    
                @Override
                public void onCompletion(IMediaPlayer mp) {
                }
    
                @Override
                public boolean onError(IMediaPlayer mp, int what, int extra) {
                    return false;
                }
    
                @Override
                public boolean onInfo(IMediaPlayer mp, int what, int extra) {
                    return false;
                }
    
                @Override
                public void onPrepared(IMediaPlayer mp) {
                    // 视频准备好播放了，但是他不会自动播放，需要手动让他开始。
                    mp.start();
                }
    
                @Override
                public void onSeekComplete(IMediaPlayer mp) {
    
                }
    
                @Override
                public void onVideoSizeChanged(IMediaPlayer mp, int width, int height, int sar_num, int sar_den) {
                    //在此可以获取到视频的宽和高
                }
            });

1.  在xml中放入播放器控件
2.  在activity中加载so包，设置监听器，设置路径

//加载native库
    try {
        IjkMediaPlayer.loadLibrariesOnce(null);
        IjkMediaPlayer.native_profileBegin("libijkplayer.so");
     } catch (Exception e) {
        this.finish();
     }
    ijkPlayer.setListener(...)
    ijkPlayer.setVideoPath(path);

记得在onStop()方法中关闭native库

IjkMediaPlayer.native_profileEnd();

这样就完成了一个简单的视频播放器了。

### 注意事项 ###

1，IjkMediaPlayer的setDataSource是不建议重新赋值的，每次更改视频源都需要：player.release() -> create new player -> player.setDataSource。

但是SurfaceView并不需要每次都重新创建。

2，设置倍速播放：IjkMediaPlayer.setSpeed();

3，一些重要的视频信息返回码（这些信息返回码可以从监听器的onInfo()方法中获得）：

int MEDIA_INFO_VIDEO_RENDERING_START = 3;//视频准备渲染
    int MEDIA_INFO_BUFFERING_START = 701;//开始缓冲
    int MEDIA_INFO_BUFFERING_END = 702;//缓冲结束
    int MEDIA_INFO_VIDEO_ROTATION_CHANGED = 10001;//视频选择信息
    int MEDIA_ERROR_SERVER_DIED = 100;//视频中断，一般是视频源异常或者不支持的视频类型。
    int MEDIA_ERROR_IJK_PLAYER = -10000,//一般是视频源有问题或者数据格式不支持，比如音频不是AAC之类的
    int MEDIA_ERROR_NOT_VALID_FOR_PROGRESSIVE_PLAYBACK = 200;//数据错误没有有效的回收

参考资料：

[在ubuntu下编译ijkplayer-android][ubuntu_ijkplayer-android]

[视频直播技术（四）：使用Ijkplayer播放直播视频][Ijkplayer]

> 本文在开源项目：[https://github.com/Android-Alvin/Android-LearningNotes][https_github.com_Android-Alvin_Android-LearningNotes] 中已收录，里面包含不同方向的自学编程路线、面试题集合/面经、及系列技术文章等，资源持续更新中…

[ijkplayer_github]: https://link.jianshu.com?t=https://github.com/Bilibili/ijkplayer
[github]: https://link.jianshu.com?t=https://github.com/thiagooo0/lmnplayer
[ubuntu_ijkplayer-android]: https://link.jianshu.com?t=http://blog.csdn.net/u010072711/article/details/51438871
[Ijkplayer]: https://link.jianshu.com?t=http://www.cnblogs.com/renhui/p/6420140.html
[https_github.com_Android-Alvin_Android-LearningNotes]: https://links.jianshu.com/go?to=https%3A%2F%2Fgithub.com%2FAndroid-Alvin%2FAndroid-P7%2Fblob%2Fmaster%2FAndroid%25E5%25BC%2580%25E5%258F%2591%25E8%25BF%2598%25E4%25B8%258D%25E4%25BC%259A%25E8%25BF%2599%25E4%25BA%259B%25EF%25BC%259F%25E5%25A6%2582%25E4%25BD%2595%25E9%259D%25A2%25E8%25AF%2595%25E6%258B%25BF%25E9%25AB%2598%25E8%2596%25AA%25EF%25BC%2581.md