原生安卓播放器不支持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中放入播放器控件。
-
在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