安卓部署ffmpeg全平台so并实现命令行调用

安卓 FFmpeg系列

第一章 Ubuntu生成ffmpeg安卓全平台so
第二章 Windows生成ffmpeg安卓全平台so
第三章 生成支持x264的ffmpeg安卓全平台so
第四章 部署ffmpeg安卓全平台so并使用（本章）

---

---

前言

前面的章节实现了ffmpeg全平台so的生成，接下来的步骤就是部署以及使用了，部署so还是比较简单的，用gradle和cmake都可以部署，部署好了就可以直接使用了，如果需要c++进行封装一层，则需要链接，对cmake熟悉的话链接也是比较简单的。

---

一、添加so

1、拷贝ffmpeg到项目

ffmpeg的生成方法可以参考前面三章，或者使用第二章 生成好的包。将ffmpeg生成好的包拷贝到如下目录。

并将so放到对应abi的目录中。

2、build.gradle指定so目录

指定的目录为abi名称的上一级。

sourceSets {main {jniLibs.srcDirs = ['src/main/cpp/jniLibs/ffmpeg4.3.6/24']       }}

如果是jni或者flutter的ffi直接调用ffmpeg的符号，则到这一步就结束了。
通过jni或ffi直接调用命令行：可以使用第三章 生成的包，里面有个libffmpeg.so，包含了ffmpeg的main符号，可以通过ffi直接调用。但需要解决2个问题：1、字符串解析为argc、argv。（dart.可参考附录）2、中断ffmpeg的exit操作。
否则继续往下

---

二、调用命令行

此步骤依赖第三章 生成的包：libffmpeg.so，是ffmpeg可执行程序，笔者将其生成了so。

1、新建CMakeLists链接ffmpeg的so

在项目中新建一个CMakeLists.txt，用于生成c++代码。

在CMakeLists.txt中填入以下内容，会链接ffmpeg的所有so，以及包含头文件。

# Sets the minimum version of CMake required to build the native library.
cmake_minimum_required(VERSION 3.4.1)
#拼接ffmpeg目录
set(PREFIX "${CMAKE_SOURCE_DIR}/jniLibs/ffmpeg4.3.6/24/${ANDROID_ABI}")
#包含ffmpeg头文件目录
include_directories(${PREFIX}/include)
#添加链接目录
link_directories(${PREFIX})
# 搜索ffmpeg目录下的所有.so文件
file(GLOB SO_FILES  "${PREFIX}/*.so" )  
# 获取目录下所有库名
foreach(SO_FILE IN LISTS SO_FILES)# 获取不带路径的文件名get_filename_component(LIB_NAME ${SO_FILE} NAME)list(APPEND FFMPEG_LIBRARIES "${LIB_NAME}")
endforeach()find_library( log-liblog )add_library( ffmpeg_v4_native-libSHAREDnative-lib.cpp
)target_link_libraries(ffmpeg_v4_native-lib#ffmpeg链接到native-lib${FFMPEG_LIBRARIES}${log-lib}android
)

在build.gradle中关联CmakeLists.txt

externalNativeBuild {cmake {path "src/main/cpp/CMakeLists.txt"}
}

2、封装命令行方法

此步骤依赖第三章 生成的包：libffmpeg.so，是ffmpeg可执行程序，笔者将其生成了so。
新建一个cpp文件用于实现ffmpeg命令行的调用。

（1）、导入main符号

// 导入ffmpeg的main符号,直接jni或者ffi调用也行，但是需要解决一个问题：ffmpeg内部会调用exit退出进程，在安卓会导致Activity退出。
//目前本文件的解决方案是在exit过程中抛出c++异常并捕获，中断后续退出操作。
extern "C" int main(int argc, char **argv);

（2）、将字符串解析为argc、argv

参考C++ 将字符串解析为argc、argv

（3）、注册log回调输出安卓日志

输出安卓日志方便调试。

//  自定义的日志回调函数，输入安卓日志
av_log_set_callback([](void *avcl, int level, const char *fmt, va_list vl){if (level >= 0)level &= 0xff;if (level > av_log_get_level())return;AVBPrint part;av_bprint_init(&part, 0, 65536);av_vbprintf(&part, fmt, vl);//打印安卓日志标签为ffmpeg__android_log_print(ANDROID_LOG_INFO, "ffmpeg", "%s", part.str);av_bprint_finalize(&part, NULL); });

（4）、阻止exit退出

ffmpeg中有大量异常流程会调用exit，会导致整个进程退出，所以需要阻止这种情况，我们可以注册atexit并抛出异常，中断exit操作。

atexit([](){ throw 0; });

try catch中捕获异常，避免程序终止。

try
{// 调用ffmpeg的mainreturn main(argv.size(), argv.data());
}
catch (...)
{
//main里面调用了exit会走到这里。
}

完整代码

在native-lib.cpp中加入如下代码

#include <jni.h>
#include <dlfcn.h>
#include <android/log.h>
#include <mutex>
#include <iostream>
#include <sstream>
#include <vector>
#include <string>
extern "C"
{
#include <libavutil/log.h>
#include <libavutil/bprint.h>
}
// 导入ffmpeg的main符号,直接jni或者ffi调用也行，但是需要解决一个问题：ffmpeg内部会调用exit退出进程，在安卓会导致Activity退出。
//目前本文件的解决方案是在exit过程中抛出c++异常并捕获，中断后续退出操作。
extern "C" int main(int argc, char **argv);
static std::vector<std::string> split(const std::string &str, char delim);
static std::vector<std::string> parseArgv(const std::string &str);
static bool _isFFmpegInit = false;
static std::mutex _mtx;
// 调用ffmpeg命令行，参数是命令行,例如：ffmpeg --version
extern "C" int ffmpeg_exec(char *shell)
{if (!_isFFmpegInit){std::unique_lock<std::mutex> lck(_mtx);if (!_isFFmpegInit){//  自定义的日志回调函数av_log_set_callback([](void *avcl, int level, const char *fmt, va_list vl){if (level >= 0)level &= 0xff;if (level > av_log_get_level())return;AVBPrint part;av_bprint_init(&part, 0, 65536);av_vbprintf(&part, fmt, vl);__android_log_print(ANDROID_LOG_INFO, "ffmpeg", "%s", part.str);av_bprint_finalize(&part, NULL); });// 注册退出回调，在回调触发异常，阻止ffmpeg调用exit进程退出。atexit([](){ throw 0; });_isFFmpegInit = true;}}try{// 解析命令行auto strArgv = parseArgv(shell);std::vector<char *> argv;for (int i = 0; i < strArgv.size(); i++)argv.push_back((char *)strArgv[i].c_str());// 调用ffmpeg的mainreturn main(argv.size(), argv.data());}catch (...){}return -1;
}static std::vector<std::string> split(const std::string &str, char delim)
{std::vector<std::string> tokens;std::istringstream iss(str);std::string token;while (std::getline(iss, token, delim))if (!token.empty())tokens.push_back(token);return tokens;
}
static std::vector<std::string> parseArgv(const std::string &str)
{std::vector<std::string> args;int n = 0;for (auto i : split(str, '"')){if (n++ % 2 == 0)for (auto j : split(i, ' '))args.push_back(j);elseargs.push_back(i);}return args;
}

3、dart ffi调用

导入方法，上一步生成的库名称是libffmpeg_v4_native-lib.so，里面提供的符号是ffmpeg_exec。

import 'package:ffi/ffi.dart';
import 'dart:ffi';
final int Function(Pointer<Utf8> shell) _ffmpeg_exec =DynamicLibrary.open("libffmpeg_v4_native-lib.so").lookup<NativeFunction<Int32 Function(Pointer<Utf8>)>>('ffmpeg_exec').asFunction(isLeaf: true);

封装成dart方法

//执行ffmpeg命令行。
int ffmpegExec(String s) {final cmd = s.toNativeUtf8();final ret = _ffmpeg_exec(cmd);malloc.free(cmd);return ret;
}

4、java jni调用

查找android使用jna调用so的方法。按上述步骤生成的so名称为libffmpeg_v4_native-lib.so，符号对应java为int ffmpeg_exec(String s)

---

三、完整代码

flutter示例项目，已加入第二章生成好的包里。

---

四、使用示例

1、flutter调用命令行rtsp拉流

作为测试命令，-f以及输出为空

Future<void> main() async {ffmpegExec("ffmpeg -rtsp_transport tcp -i  rtsp://rtspstream:a4388c5a3f8c06031368479b29087a09@zephyr.rtsp.stream/movie  -vcodec  copy  -f  null  _  ");runApp(const MyApp());
}

效果预览

---

总结

以上就是今天讲述的内容，ffmpeg的so部署还是比较容易的，但是命令行的调用会麻烦一些，尤其是要解决ffmpeg退出问题，在c++中比较好解决，java理论上也比较好实现，如果在dart中则会比较麻烦，因为dart的方法通常不能跨线程调用，多线程的情况会出问题。

---

附录

1、dart将字符串解析为argc、argv

//将字符串解析为argv
List<String> _stringToArgv(String input) {// 使用正则表达式分割字符串// 这里使用了简单的空白字符分割，但是不会处理引号内的空格var parts = input.split(RegExp(r'\s+'));// 处理引号内的文本var argv = <String>[];for (var part in parts) {if (part.startsWith('"') && part.endsWith('"')) {// 去除引号argv.add(part.substring(1, part.length - 1));} else if (part.isNotEmpty) {argv.add(part);}}return argv;
}

将字符串数组，转为native type的argc、argv。
下列代码资源释放略

final args = _stringToArgv(s);
final argc=args.length;
final argv =calloc.allocate<Pointer<Char>>(sizeOf<Pointer>() * (args.length));for (int i = 0; i < args.length; i++) {argv[i] = args[i].toNativeUtf8().cast();}