ExoPlayer(AndroidX Media3) 扩展ffmpeg实现音频软解码
环境准备:
1.Ubuntu 20.04.4 LTS
2.AndroidNDK版本r26C
3.AndroidStudio 2023.1.1(配置好SDK和JDK 17.0.10)
4.ffmpeg6.0源码
5.ExoPlayer源码,AndroidX Media release分支版本
操作步骤:
1.下载Exoplayer源码
目前官方已废弃Exopler2,代码已经迁移到AndroidX Media,下载完成设置FFMPEG_MODULE_PATH变量
1.git clone https://github.com/androidx/media
2.cd media && FFMPEG_MODULE_PATH="$(pwd)/libraries/decoder_ffmpeg/src/main"
2.下载NDK
官网下载NDK或者通过SDKManager安装
下载完成后解压,设置NDK_PATH变量
1.unzip android-ndk-r26c-linux.zip
2.cd android-ndk-r26c && NDK_PATH="$(pwd)"
3.设置编译平台
Lunux为
HOST_PLATFORM="linux-x86_64"
MacOX为
HOST_PLATFORM="darwin-x86_64"
4.设置最小支持Android版本
通常为项目设置的minSDK版本,NDKr26最小支持SDK为21
ANDROID_ABI=23
5.下载ffmpeg源码
下载源码并设置FFMPEG_PATH变量
git clone git://source.ffmpeg.org/ffmpeg && \ cd ffmpeg && \ git checkout release/6.0 && \ FFMPEG_PATH="$(pwd)"
6.配置解码器格式
根据自己需要解码的格式设置,具体支持的解码格式参考官网
ENABLED_DECODERS=(aac ac3 mp3 flac)
7.关联ffmpeg源码
将ExoPlayer源码中ffmpeg模块jni与ffmpeg源码关联,关联成功后会在jni目录中生成一个快捷方式指向ffmpeg源码目录
1.cd "${FFMPEG_MODULE_PATH}/jni"
2.ln -s "$FFMPEG_PATH" ffmpeg
8.编译ffmpeg
编译成功后,会在ffmepg目录下生成一个android-libs目录
./build_ffmpeg.sh \ "${FFMPEG_MODULE_PATH}" "${NDK_PATH}" "${HOST_PLATFORM}" "${ANDROID_ABI}" "${ENABLED_DECODERS[@]}"
9.编译生成Android项目依赖的aar包
退回到ExoPlayer项目工程目录执行,编译成功后会在\libraries\decoder_ffmpeg\buildout\outputs\aar\目录生成aar包
./gradlew lib-decoder-ffmpeg:assembleRelease
10.项目使用
复制生成的aar包到项目libs目录,修改app下的build.gradle文件,引用aar包
implementation(files("libs/extension-ffmpeg-release.aar"))
自定义DefaultRenderersFactory,构造ExoPlayer实例时传入,日志中有ffmpeg相关信息代表加载成功。
11.常见问题
1.shell变量属于临时设置,只在当前窗口生效,新打开命令窗口后需要重新设置,运行build_ffmpeg.sh脚本时会打印相关变量信息,注意查看是否正确。
2.编译ffmpeg源码和生成aar时NDK最好保持一致,否则生成aar包时可能报错。
3.编译时下载Gradle和同步Maven库很慢或超时可以设置国内镜像源,参考AndroidStudio配置腾讯镜像地址
4.教程参考官方开发者指南README.md。