告别LibVLC的OOM：手把手教你编译支持H265 RTSP的ijkplayer（Android NDK r14b + Gradle 6.1.1适配）-程序员充电站

深度定制ijkplayer：从源码编译到H265 RTSP流播放全解析

在Android视频播放开发领域，内存溢出（OOM）问题一直是开发者面临的棘手挑战。许多开发者曾依赖LibVLC-android作为解决方案，但其长期存在的内存泄漏问题让项目稳定性大打折扣。本文将带你深入ijkplayer的定制化编译过程，彻底解决H265编码RTSP流播放的难题。

1. 为什么选择ijkplayer替代LibVLC

LibVLC-android虽然功能强大，但在实际应用中暴露出的内存管理问题令人头疼。测试多个版本（从3.1.0到4.0.0-eap12）后发现：

内存泄漏严重：播放次数增加时内存持续增长，最终导致OOM
UI组件兼容性问题：必须使用特定VLCVideoLayout才能缓解内存泄漏
功能缺陷：某些版本修复了OOM却导致音量控制失效

相比之下，基于FFmpeg的ijkplayer具有明显优势：

特性	LibVLC-android	ijkplayer
内存管理	存在泄漏风险	稳定可控
H265支持	是	需定制编译
RTSP协议支持	是	需启用配置
硬件解码	部分支持	全面支持
项目维护状态	活跃	已停止更新

关键差异：ijkplayer需要手动编译开启特定功能，但由此带来的稳定性和性能提升值得投入。

2. 编译环境准备与基础配置

2.1 工具链安装

确保系统已安装以下组件：

# 检查NDK版本 $ANDROID_NDK_HOME/ndk-build --version # 输出应显示NDK r14b或兼容版本 # 验证Gradle gradle -v # 需要6.1.1版本

环境变量配置示例：

export ANDROID_NDK=/path/to/android-ndk-r14b export ANDROID_SDK=/path/to/android-sdk export PATH=$PATH:$ANDROID_NDK:$ANDROID_SDK/platform-tools

2.2 源码获取与初始化

git clone https://github.com/Bilibili/ijkplayer.git cd ijkplayer git checkout -B latest k0.8.8 # 初始化子模块 ./init-android.sh ./init-android-openssl.sh

注意：建议使用国内镜像加速依赖下载，如在init-android.sh中将github.com替换为ghproxy.com镜像地址。

3. 关键编译配置修改

3.1 启用RTSP和H265支持

修改config/module-lite.sh：

export COMMON_FF_CFG_FLAGS="$COMMON_FF_CFG_FLAGS --enable-pthreads" +export COMMON_FF_CFG_FLAGS="$COMMON_FF_CFG_FLAGS --enable-mediacodec" +export COMMON_FF_CFG_FLAGS="$COMMON_FF_CFG_FLAGS --enable-jni" export COMMON_FF_CFG_FLAGS="$COMMON_FF_CFG_FLAGS --enable-network" -export COMMON_FF_CFG_FLAGS="$COMMON_FF_CFG_FLAGS --disable-protocol=rtp" +export COMMON_FF_CFG_FLAGS="$COMMON_FF_CFG_FLAGS --enable-protocol=rtp" +export COMMON_FF_CFG_FLAGS="$COMMON_FF_CFG_FLAGS --enable-demuxer=rtsp"

3.2 修复Android平台识别

修改android/contrib/tools/do-compile-ffmpeg.sh：

FF_CFG_FLAGS="$FF_CFG_FLAGS --cross-prefix=${FF_CROSS_PREFIX}-" FF_CFG_FLAGS="$FF_CFG_FLAGS --enable-cross-compile" -FF_CFG_FLAGS="$FF_CFG_FLAGS --target-os=linux" +FF_CFG_FLAGS="$FF_CFG_FLAGS --target-os=android"

4. 分步编译流程

4.1 编译OpenSSL

cd android/contrib ./compile-openssl.sh clean ./compile-openssl.sh armv7a

常见问题解决：

遇到jni not found错误时，检查NDK路径是否包含platforms目录
内存不足时可添加-j4参数限制并行编译线程数

4.2 编译FFmpeg

./compile-ffmpeg.sh clean ./compile-ffmpeg.sh armv7a

编译成功后检查输出：

android/contrib/build/ffmpeg-armv7a/output/ ├── include ├── lib └── share

4.3 编译ijkplayer核心库

cd .. ./compile-ijk.sh armv7a

生成的关键文件：

ijkplayer-java/src/main/java/- Java接口层
ijkplayer-armv7a/src/main/libs/armeabi-v7a/- 原生库文件

5. 现代Android项目集成

5.1 Gradle配置升级

修改build.gradle关键配置：

buildscript { repositories { google() maven { url 'https://maven.aliyun.com/repository/jcenter' } } dependencies { classpath 'com.android.tools.build:gradle:4.0.1' } } android { defaultConfig { externalNativeBuild { ndkBuild { abiFilters 'armeabi-v7a' } } } }

5.2 解决兼容性问题

常见错误及解决方案：

base-extension报错：删除build.gradle中过时的插件声明
NDK版本不匹配：在local.properties中明确指定：
```
ndk.dir=/path/to/android-ndk-r14b
```

依赖冲突：统一使用implementation替代compile：

implementation project(':ijkplayer-java') implementation project(':ijkplayer-armv7a')

6. 高级播放配置与优化

6.1 播放器初始化参数

IjkMediaPlayer mediaPlayer = new IjkMediaPlayer(); mediaPlayer.setOption(IjkMediaPlayer.OPT_CATEGORY_PLAYER, "mediacodec-all-videos", 1); mediaPlayer.setOption(IjkMediaPlayer.OPT_CATEGORY_PLAYER, "mediacodec-hevc", 1); mediaPlayer.setOption(IjkMediaPlayer.OPT_CATEGORY_FORMAT, "rtsp_transport", "tcp"); mediaPlayer.setOption(IjkMediaPlayer.OPT_CATEGORY_FORMAT, "analyzemaxduration", 100); mediaPlayer.setOption(IjkMediaPlayer.OPT_CATEGORY_FORMAT, "probesize", 10240);

6.2 延迟优化方案

缓冲区控制：

mediaPlayer.setOption(IjkMediaPlayer.OPT_CATEGORY_PLAYER, "packet-buffering", 0); mediaPlayer.setOption(IjkMediaPlayer.OPT_CATEGORY_PLAYER, "framedrop", 1);

实时监控：

mediaPlayer.setOnNativeInvokeListener(new IjkMediaPlayer.OnNativeInvokeListener() { @Override public boolean onNativeInvoke(int what, Bundle args) { // 处理底层事件 return false; } });

7. 实战问题排查指南

7.1 播放失败诊断流程

检查协议支持：

String format = mediaPlayer.getVideoFormat(); Log.d("Player", "Video format: " + format);

验证解码器状态：

boolean hwDecodeEnabled = mediaPlayer.getOption( IjkMediaPlayer.OPT_CATEGORY_PLAYER, "mediacodec-hevc" ) == 1;

网络连接分析：

mediaPlayer.setOption( IjkMediaPlayer.OPT_CATEGORY_FORMAT, "http-detect-range-support", 0 );

7.2 性能优化参数对照表

参数	推荐值	作用域	影响范围
mediacodec-auto-rotate	1	播放器	视频旋转处理
opensles	0	音频	延迟/兼容性
overlay-format	842225234	视频输出	色彩空间
start-on-prepared	1	控制流	播放启动速度
max-buffer-size	524288	网络缓冲	内存占用/流畅度