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

作者: koinzhang | 来源:发表于2021-04-18 23:46 被阅读0次

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

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

编译ijkplayer

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

使用Homebrew安装yasm、pkg-config。
下载NDK官网地址，编译ffmpeg时会用到，编译ijkplayer中的ffmpeg需要NDK-r10 ～ NDK-r14版本，其它版本可能会报错。
在命令行中依次运行：

    # 克隆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版本)

引入编译好的.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'

自定义播放控件。 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)
            }
        }
     }

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

abstract class VideoPlayerListener : IMediaPlayer.OnBufferingUpdateListener,
         IMediaPlayer.OnCompletionListener, IMediaPlayer.OnPreparedListener, IMediaPlayer.OnInfoListener,
         IMediaPlayer.OnVideoSizeChangedListener, IMediaPlayer.OnErrorListener,
         IMediaPlayer.OnSeekCompleteListener

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

在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"/>

在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();

注意事项

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

但是SurfaceView并不需要每次都重新创建。
设置倍速播放：IjkMediaPlayer.setSpeed();
一些重要的视频信息返回码（这些信息返回码可以从监听器的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

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

编译ijkplayer

ijkplayer简单使用(Kotlin版本)

注意事项

相关文章

网友评论

延伸阅读

深度阅读

栏目导航

热点阅读