阅读 469

Mac系统下编译并使用ijkplyer播放器

原生安卓播放器不支持avi格式视频的播放,需要引入第三方播放器。ijkplayer是B站出品的一款的轻量开源播放器,可以通过编译配置支持多种格式视频的播放,本文记录在mac下编译使用ijkplayer的全过程。

开发环境:macOS-11.2.3+Android Studio-4.1.2+ijkplayer-0.8.8

编译ijkplayer

根据官网的编译步骤即可进行,在容易出错的地方会标明注意事项。

  1. 使用Homebrew安装yasm、pkg-config。

  2. 下载NDK官网地址,编译ffmpeg时会用到,编译ijkplayer中的ffmpeg需要NDK-r10 ~ NDK-r14版本,其它版本可能会报错。

  3. 在命令行中依次运行:

    # 克隆ijkplayer项目源码
    git clone https://github.com/Bilibili/ijkplayer.git ijkplayer-android
    
    # 进入ijkplayer目录
    cd ijkplayer-android
    
    # 切换到最新代码分支
    git checkout -B latest k0.8.8
    
    # 检查并下载ffmpeg代码
    # 需要注意因为github网速原因,很容易会下载失败,有条件可以科学上网
    # 或者多重试几次,让代码分次下载
    ./init-android.sh
    
    # 配置文件在ijkplayer-android/config目录下,可以手动修改module.sh配置
    # ijkplayer使用的默认配置是module-lite.sh,其他两种配置目前是被废弃状态,直接切换使用时会报错linux/perf_event.h: No such file or directory,需要添加配置:
    # export COMMON_FF_CFG_FLAGS="$COMMON_FF_CFG_FLAGS --disable-linux-perf"
    # export COMMON_FF_CFG_FLAGS="$COMMON_FF_CFG_FLAGS --disable-bzlib"
    # 1.module-default.sh 支持较多格式(完全编译,几乎所有格式都支持了),文件较大
    # 2.module-lite-hevc.sh 支持较少格式,包含hevc
    # 3.module-lite.sh 支持较少格式(默认)
    cd config
    rm module.sh
    ln -s module-lite.sh module.sh
    source module.sh
    # 手动修改配置文件module-lite.sh,例如要支持avi格式视频播放,在module.sh文件中,加上
    # export COMMON_FF_CFG_FLAGS="$COMMON_FF_CFG_FLAGS --enable-muxer=avi"
    # export COMMON_FF_CFG_FLAGS="$COMMON_FF_CFG_FLAGS --enable-demuxer=avi"
    # 此外还要将export COMMON_FF_CFG_FLAGS="$COMMON_FF_CFG_FLAGS --disable-demuxers"
    # 修改为export COMMON_FF_CFG_FLAGS="$COMMON_FF_CFG_FLAGS --enable-demuxers"
    # enable-muxer和enable-demuxer两项是配置支持更多格式视频,后面加上需要支持的格式即可支持播放,另外--disable-demuxers需要改为--enable-demuxers
    # 手动修改module-lite.sh的配置支持avi格式视频这种方式我这一直没办法成功,最后直接把module配置切换到了module-default.sh,成功播放avi视频
    
    # 编译ffmpeg,需要用到NDK,ijkplayer编译的NDK版本需要10~14。配置NDK有两种方式
    # 1.在~/.zshrc中添加系统环境
    #  终端输入vim ~/.zshrc
    #  在打开的文件中,插入:
    #  export ANDROID_NDK=/Users/xxxxx/android-ndk-r14b #ANDROID_NDK换成自己NDK路径
    #  export PATH=${PATH}:${ANDROID_NDK}
    #  终端输入source ~/.zshrc 使生效
    #  键入ndk-build -v 验证NDK配置是否生效
    #  但是第一种方式对我无效,编译ffmpeg时仍然会提示没有没找到ANDROID_NDK,所以如果第一种方式无效推荐使用第二种方式
    # 2.在终端命令行中通过export引入路径,终端键入:export ANDROID_NDK=/Users/xxxxx/android-ndk-r14b,然后再编译ffmpeg
    cd android/contrib
    export ANDROID_NDK=/Users/xxxxx/android-ndk-r14b
    ./compile-ffmpeg.sh clean
    ./compile-ffmpeg.sh all
    
    cd ..
    ./compile-ijk.sh all
    
    # 最后编译好的so库在ijkplayer-android/android/ijkplayer/ijkplayer-${CPU}/src/main/libs目录下
    # CPU = arm64/armv5/armv7a/x86/x86_64
    
    复制代码

ijkplayer简单使用(Kotlin版本)

  1. 引入编译好的.so文件。

    • 在项目工程中的app/src/main目录下新建jniLibs目录,将需要使用的CPU型号的.so包移动到jniLibs中。以 x86 型号为例,将ijkplayer-android/android/ijkplayer/ijkplayer-x86/src/main/libs目录下的文件夹移动到jniLibs目录下。

    • 在app的build.gradle文件中添加ijkplayer依赖。

      //必须依赖
      implementation 'tv.danmaku.ijk.media:ijkplayer-java:0.8.8'
      
      //因为是使用自己编译的so库,所以不需要添加以下依赖,其以下依赖是ijkplayer默认配置,如果不使用自己编译so库,则添加一下依赖
      //    // Other ABIs: optional
      //    implementation 'tv.danmaku.ijk.media:ijkplayer-armv7a:0.8.8'
      //    implementation 'tv.danmaku.ijk.media:ijkplayer-arm64:0.8.8'
      //    implementation 'tv.danmaku.ijk.media:ijkplayer-x86:0.8.8'
      //    implementation 'tv.danmaku.ijk.media:ijkplayer-x86_64:0.8.8'
      
      //对exo播放器的封装,实验性功能
      //    implementation 'tv.danmaku.ijk.media:ijkplayer-exo:0.8.8'
      复制代码
  2. 自定义播放控件。 ijkplayer提供的没有提供一个播放器控件给我们使用,所以需要和surfaceview组合成播放控件类。主要是创建一个surfaceview,把它赋给IMediaPlayer。

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

    abstract class VideoPlayerListener : IMediaPlayer.OnBufferingUpdateListener,
        IMediaPlayer.OnCompletionListener, IMediaPlayer.OnPreparedListener, IMediaPlayer.OnInfoListener,
        IMediaPlayer.OnVideoSizeChangedListener, IMediaPlayer.OnErrorListener,
        IMediaPlayer.OnSeekCompleteListener
    复制代码

    当实现这个抽象类的时候,最重要的是在onPrepared()方法中,让视频开始播放。

  4. 在xml中放入播放器控件。

        <com.bupt.compose3dvideo.ijkplayer.IJKVideoPlayer
            android:id="@+id/ijk_player"
            android:layout_width="@dimen/dimen_0"
            android:layout_height="@dimen/dimen_0"
            app:layout_constraintBottom_toBottomOf="parent"
            app:layout_constraintEnd_toEndOf="parent"
            app:layout_constraintStart_toStartOf="parent"
            app:layout_constraintTop_toBottomOf="@id/add_video"
            android:layout_marginTop="@dimen/dimen_16"
            android:layout_marginBottom="@dimen/dimen_100"/>
    复制代码
  5. 在activity/fragment中初始化并调用。

    初始化:

     		//加载native库
            try {
                IjkMediaPlayer.loadLibrariesOnce(null)
                IjkMediaPlayer.native_profileBegin("libijkplayer.so")
            } catch (e: Exception) {
                this.finish()
            }
    		//使用
            binding.ijkPlayer.setVideoPath(filePath)
            binding.ijkPlayer.setListener(object : VideoPlayerListener() {
                override fun onBufferingUpdate(p0: IMediaPlayer?, p1: Int) {
                    TODO("Not yet implemented")
                }
    
                override fun onCompletion(p0: IMediaPlayer?) {
                    TODO("Not yet implemented")
                }
                
    			//准备好之后播放视频
                override fun onPrepared(p0: IMediaPlayer?) {
                    p0!!.start()
                }
    
                override fun onInfo(p0: IMediaPlayer?, p1: Int, p2: Int): Boolean {
                    TODO("Not yet implemented")
                }
    
                override fun onVideoSizeChanged(p0: IMediaPlayer?, p1: Int, p2: Int, p3: Int, p4: Int) {
                    TODO("Not yet implemented")
                }
    
                override fun onError(p0: IMediaPlayer?, p1: Int, p2: Int): Boolean {
                    TODO("Not yet implemented")
                }
    
                override fun onSeekComplete(p0: IMediaPlayer?) {
                    TODO("Not yet implemented")
                }
            })
    复制代码

    在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;//数据错误没有有效的回收
复制代码

参考文章:

ijkplayer编译so库真没那么难

iOS开发FFmpeg编译裁剪支持avi

ijkplayer编译 定NDK 路径

Android 超好用的播放器——ijkplayer

文章分类
Android
文章标签