在安卓中使用 FFmpegKit 剪切视频并添加文字水印
在安卓中用到的三方库：https://github.com/arthenica/ffmpeg-kit
这个库很强大，支持很多平台，每个平台都有各自的分支代码，用了一段时间，稳定性挺好的，
找到安卓下的分支：FFmpegKit for Android FFmpegKit Android 版
引入项目：
repositories {mavenCentral()
}dependencies {implementation 'com.arthenica:ffmpeg-kit-full:6.0-2'
}
每个平台下，又分为多个库，每个库包含不同的功能，因为功能越丰富，导入到项目中编译的包体积越大，尽量选择适合自己功能的库进行使用。
📦 FFmpeg 编译配置选项（库依赖分类）
| 配置项 | 说明 | 包含的库 |
|---|---|---|
min | 最小化构建 | - |
min-gpl | 最小化构建并启用 GPL 库 | vid.stab, x264, x265, xvidcore |
https | 启用 HTTPS 支持（使用非-GPL 依赖） | gmp, gnutls |
https-gpl | 启用 HTTPS 支持（使用 GPL 兼容依赖） | gmp, gnutls, vid.stab, x264, x265, xvidcore |
audio | 启用音频相关编码器/解码器 | lame, libilbc, libvorbis, opencore-amr, opus, shine, soxr, speex, twolame, vo-amrwbenc |
video | 启用视频相关编码器/解码器 | dav1d, fontconfig, freetype, fribidi, kvazaar, libass, libiconv, libtheora, libvpx, libwebp, snappy, zimg |
full | 启用所有非 GPL 第三方库 | dav1d, fontconfig, freetype, fribidi, gmp, gnutls, kvazaar, libass, libiconv, libilbc, libtheora, libvorbis, libvpx, libwebp, libxml2, opencore-amr, opus, shine, snappy, soxr, speex, twolame, vo-amrwbenc, zimg |
full-gpl | 启用所有库（包括 GPL） | dav1d, fontconfig, freetype, fribidi, gmp, gnutls, kvazaar, lame, libass, libiconv, libilbc, libtheora, libvorbis, libvpx, libwebp, libxml2, opencore-amr, opus, shine, snappy, soxr, speex, twolame, vid.stab, vo-amrwbenc, x264, x265, xvidcore, zimg |
比如你如果只需要保存 rtsp 视频流 和 推流的话，只需要导入 min-gpl即可：
implementation 'com.arthenica:ffmpeg-kit-min-gpl:6.0-2'
如果你想要更多，比如添加水印，就涉及到 FFmpeg 滤镜相关功能，就需要引入full-gpl：
implementation 'com.arthenica:ffmpeg-kit-full-gpl:6.0-2'
具体需要什么功能，可以进去看说明，说明没有涉及到的，并且你不想用全功能库，你也可以一个一个试试，也许就能满足你。
正文开始
由说明可知，使用方式为：
import com.arthenica.ffmpegkit.FFmpegKit;FFmpegSession session = FFmpegKit.execute("-i file1.mp4 -c:v mpeg4 file2.mp4");
if (ReturnCode.isSuccess(session.getReturnCode())) {// SUCCESS} else if (ReturnCode.isCancel(session.getReturnCode())) {// CANCEL} else {// FAILURELog.d(TAG, String.format("Command failed with state %s and rc %s.%s", session.getState(), session.getReturnCode(), session.getFailStackTrace()));}
或者异步调用：
FFmpegKit.executeAsync("-i file1.mp4 -c:v mpeg4 file2.mp4", new FFmpegSessionCompleteCallback() {@Overridepublic void apply(FFmpegSession session) {SessionState state = session.getState();ReturnCode returnCode = session.getReturnCode();// CALLED WHEN SESSION IS EXECUTEDLog.d(TAG, String.format("FFmpeg process exited with state %s and rc %s.%s", state, returnCode, session.getFailStackTrace()));}
}, new LogCallback() {@Overridepublic void apply(com.arthenica.ffmpegkit.Log log) {// CALLED WHEN SESSION PRINTS LOGS}
}, new StatisticsCallback() {@Overridepublic void apply(Statistics statistics) {// CALLED WHEN SESSION GENERATES STATISTICS}
});
与正常 ffmpeg 命令不同的是，在传入命令时，前面不需要加 “ffmpeg” 关键字，只需传入后面的具体命令即可，加上会报错哦！
关键代码：
搞了好久才凑齐的正确代码，这东西真不能听 AI 的一面之辞，不然就被 AI 一条路领到黑，
private static String buildWatermarkCommand(VideoFile file, VideoTimeRange timeRange, String outputPath, String fontPath) {FFmpegKitConfig.setFontconfigConfigurationPath(fontPath);String drawtextFilter = String.format("drawtext=text='%s':fontfile=%s:fontcolor=white:fontsize=20:x=0:y=30",DEFAULT_WATERMARK, fontPath);List<String> commandList = new ArrayList<>();commandList.add("-ss"); // 指定输入文件的开始时间，格式：HH:MM:SScommandList.add(timeRange.startTime);commandList.add("-i"); // 输入文件路径commandList.add(file.filePath);commandList.add("-t"); // 指定持续时间，格式：HH:MM:SScommandList.add(timeRange.durationStr);commandList.add("-vf"); // 视频滤镜，用于添加水印文字commandList.add(drawtextFilter);commandList.add("-c:v"); // 视频编码器设置commandList.add(VIDEO_CODEC); // 使用H.264软件编码器commandList.add("-preset"); // 编码速度预设commandList.add(VIDEO_PRESET); // ultrafast：最快编码速度，文件稍大commandList.add("-crf"); // 恒定质量因子（0-51，越小质量越好）commandList.add(String.valueOf(VIDEO_CRF)); // 23：平衡质量和文件大小的推荐值commandList.add("-c:a"); // 音频编码器设置commandList.add("copy"); // 直接复制音频流，不重新编码commandList.add("-r");commandList.add("20"); // 每秒20帧commandList.add("-avoid_negative_ts"); // 避免负时间戳问题commandList.add("make_zero"); // 将负时间戳调整为0commandList.add(outputPath); // 输出文件路径return String.join(" ", commandList);}
简单介绍下命令作用：对一段现有的视频文件进行剪辑，-ss指定开始时间，比如要剪切的原视频时长为两分钟，所以开始时间到结束时间就是：00:00:00 - 00:02:00 , 假设要剪辑中间一分钟的视频，那么 -ss指定的开始时间为：00:00:30 , -t持续时间就是：00:01:00 , 截取的时间段为：00:00:30 - 00:01:30 ，-c:v设置编码器，一般 H.264 就够了，如果设置其他的编码器，要看你的设备支持不支持了，-r设置帧率，如果你想要剪切的视频大小小一点，一方面就可以通过降低帧率，另一方面就可以降低码率来实现(上述命令码率未指定默认按原视频码率)。
如果你指定的时间范围，超过原视频时长会报错，这很正常，只是报错内容可能看不懂，这是一个问题点！
设置 FFmpegKitConfig.setFontconfigConfigurationPath的作用是 https://github.com/arthenica/ffmpeg-kit/wiki/Tips 参考第四条：ffmpeg 需要有效的 fontconfig 配置才能在使用 drawtext filter 时渲染文本。
这里指定一个存在的字体路径即可 比如：/system/fonts/NotoSansCJK-Regular.ttc
注意：有的字体不支持中文，写入中文水印的时候会乱码！
视频处理性能测试（A133，Android 10）
测试环境
- 设备平台：A133
- 操作系统：Android 10
- 测试内容：视频加水印 vs 无水印处理
- 加水印帧率：15fps
- 视频格式：H.264 (宽高：720x576)（位率：512Kbps）
性能对比数据
| 视频时长 | 处理方式 | 耗时（ms） | 耗时（秒） | 输出文件大小 |
|---|---|---|---|---|
| 30s | 加水印 | 5214 | 5.21 | 1.5M |
| 30s | 加水印（15帧） | 3813 | 3.81 | 1.5M |
| 30s | 不加水印 | 168 | 0.17 | 0.9M |
| 60s | 加水印 | 12013 | 12.01 | 2.5M |
| 60s | 加水印（15帧） | 7392 | 7.39 | 2.5M |
| 60s | 不加水印 | 208 | 0.21 | 1.5M |
| 120s | 加水印 | 22006 | 22.01 | 5.03M |
| 120s | 加水印（15帧） | 18404 | 18.40 | 5.03M |
| 120s | 不加水印 | 277 | 0.28 | 2.8M |
| 240s | 加水印 | 50547 | 50.55 | 10.57M |
| 240s | 加水印（15帧） | 37857 | 37.86 | 10.57M |
| 240s | 不加水印 | 448 | 0.45 | 5.24M |
在 A133 平台上，加水印操作是性能瓶颈，视频重编码操作对cpu要求比较高。