在 Android 应用中为视频添加图像水印_技术教程

本文将介绍如何在 Android 应用程序中为视频添加图像水印。我们将使用 FFmpeg 工具及其 Android 封装库来实现此功能，从而将图像“烧录”到视频中，并保存带有水印的新副本。

在 Android 应用中为视频添加图像水印，通常被称为视频水印，是一种常见的需求。实现该功能的核心在于将图像叠加到视频帧上，然后将修改后的帧重新编码成新的视频文件。FFmpeg 是一个强大的跨平台多媒体处理工具，非常适合完成这项任务。以下将详细介绍如何利用 FFmpeg 及其 Android 封装库来实现视频水印功能。

1. 选择 FFmpeg Android 封装库

虽然 FFmpeg 是一个 C/C++ 库，但我们可以使用 Android 封装库在 Android 项目中使用它。目前有多个可用的封装库，例如 ffmpeg-kit。选择一个活跃维护且功能满足需求的库至关重要。

ffmpeg-kit 是一个比较流行的选择，因为它提供了较为完善的 FFmpeg 功能支持，并且有活跃的社区维护。

2. 添加 FFmpeg 库依赖

首先，需要在 Android 项目中添加 ffmpeg-kit 库的依赖。在 build.gradle 文件中添加以下依赖项：

dependencies {
    implementation 'com.arthenica:ffmpeg-kit-full:4.5.1' // 使用最新版本
}

请务必查看 ffmpeg-kit 的官方文档，以获取最新的版本号。

3. 集成 FFmpeg 代码

集成 FFmpeg 代码需要以下步骤：

导入必要的类:

import com.arthenica.ffmpegkit.FFmpegKit;
import com.arthenica.ffmpegkit.FFmpegSession;
import com.arthenica.ffmpegkit.ReturnCode;

构建 FFmpeg 命令:

使用 FFmpeg 命令来添加图像水印。以下是一个示例命令：
```
ffmpeg -i inputVideo.mp4 -i yourImage.png -filter_complex "overlay=5:5" -codec:a copy outputVideo.mp4
```
这个命令的含义如下：
- -i inputVideo.mp4: 指定输入视频文件。
- -i yourImage.png: 指定水印图像文件。
- -filter_complex "overlay=5:5": 使用 overlay 滤镜将图像叠加到视频上。5:5 表示水印图像左上角相对于视频左上角的坐标。可以根据实际需求调整坐标。
- -codec:a copy: 音频流直接复制，不做任何处理，加快处理速度。
- outputVideo.mp4: 指定
  输出视频文件。
在 Java 代码中，可以将此命令构建成字符串数组：
```
String inputVideoPath = "/path/to/your/inputVideo.mp4";
String imagePath = "/path/to/your/yourImage.png";
String outputPath = "/path/to/your/outputVideo.mp4";

String[] command = {
        "-i", inputVideoPath,
        "-i", imagePath,
        "-filter_complex", "overlay=5:5",
        "-codec:a", "copy",
        outputPath
};
```

执行 FFmpeg 命令:

使用 FFmpegKit 执行命令：

FFmpegSession session = FFmpegKit.execute(command);

if (ReturnCode.isSuccess(session.getReturnCode())) {
    // 执行成功
    Log.i("FFmpeg", "视频水印添加成功！");
} else if (ReturnCode.isCancel(session.getReturnCode())) {
    // 执行被取消
    Log.w("FFmpeg", "视频水印添加被取消！");
} else {
    // 执行失败
    Log.e("FFmpeg", "视频水印添加失败！错误码：" + session.getReturnCode());
}

4. 完整示例代码

import android.util.Log;
import com.arthenica.ffmpegkit.FFmpegKit;
import com.arthenica.ffmpegkit.FFmpegSession;
import com.arthenica.ffmpegkit.ReturnCode;

public class VideoWatermark {

    public static void addWatermark(String inputVideoPath, String imagePath, String outputPath) {
        String[] command = {
                "-i", inputVideoPath,
                "-i", imagePath,
                "-filter_complex", "overlay=5:5",
                "-codec:a", "copy",
                outputPath
        };

        FFmpegSession session = FFmpegKit.execute(command);

        if (ReturnCode.isSuccess(session.getReturnCode())) {
            // 执行成功
            Log.i("FFmpeg", "视频水印添加成功！");
        } else if (ReturnCode.isCancel(session.getReturnCode())) {
            // 执行被取消
            Log.w("FFmpeg", "视频水印添加被取消！");
        } else {
            // 执行失败
            Log.e("FFmpeg", "视频水印添加失败！错误码：" + session.getReturnCode());
        }
    }
}

5. 注意事项