在Android应用中为视频添加图像水印

  技术百科     |      2025-10-28 00:00

本文将介绍如何在Android应用中为视频添加图像水印。我们将使用FFmpeg工具,通过其Android封装库,实现在视频上叠加图像,并生成带有水印的新视频文件。本文将提供详细步骤和示例代码,帮助开发者快速实现该功能。

在Android应用中为视频添加图像水印是一个常见的需求,例如为视频添加品牌logo、时间戳或其他自定义信息。实现这一功能,我们可以借助强大的FFmpeg工具及其Android封装库。以下是详细步骤:

1. 引入FFmpeg Android封装库

首先,需要在你的Android项目中引入FFmpeg的Android封装库。 目前比较活跃的封装库是 ffmpeg-kit。你可以在项目的 build.gradle 文件中添加依赖项:

dependencies {
    implementation 'com.arthenica:ffmpeg-kit-full:6.0' // 使用 full 版本,包含所有编解码器
}

请注意,ffmpeg-kit-full 包含了所有编解码器,体积较大。如果你的应用只需要特定的编解码器,可以选择其他版本,如 ffmpeg-kit-min 或 ffmpeg-kit-video。

同步 Gradle 文件后,FFmpeg 库将被添加到你的项目中。

2. 使用FFmpeg命令添加水印

FFmpeg 提供了强大的命令行工具,可以实现各种视频处理功能。添加水印的核心命令是 overlay 滤镜。以下是一个示例命令:

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 表示水印图像左上角相对于视频左上角的偏移量 (x, y)。你可以根据需要调整这些值。
  • -codec:a copy: 直接复制音频流,避免重新编码,提高效率。
  • outputVideo.mp4: 指定输出视频文件。

3. 在Android代码中执行FFmpeg命令

接下来,我们需要在Android代码中执行上述FFmpeg命令。 使用 ffmpeg-kit 库,可以这样实现:

import com.arthenica.ffmpegkit.*;

public class VideoWatermark {

    public static void addWatermark(String inputVideoPath, String imagePath, String outputPath) {
        String ffmpegCommand = String.format("-i %s -i %s -filter_complex \"overlay=5:5\" -codec:a copy %s",
                inputVideoPath, imagePath, outputPath);

        FFmpegKit.executeAsync(ffmpegCommand, session -> {
            if (ReturnCode.isSuccess(session.getReturnCode())) {
                // 成功
                System.out.println("水印添加成功!");
            } else if (ReturnCode.isCancel(session.getReturnCode())) {
                // 用户取消
 

System.out.println("水印添加被取消!"); } else { // 失败 System.out.println("水印添加失败!"); System.out.println(String.format("Command failed with state %s and rc %s.%s", session.getState(), session.getReturnCode(), session.getFailStackTrace())); } }, log -> { // 可选:处理日志 System.out.println(log.getMessage()); }, statistics -> { // 可选:处理统计信息 System.out.println(String.format("frame: %d, time: %d, bitrate: %.2f kbits/s, speed: %.2fx", statistics.getVideoFrameNumber(), statistics.getTime(), statistics.getBitrate(), statistics.getSpeed())); }); } }

4. 使用示例

String inputVideoPath = "/sdcard/input.mp4";
String imagePath = "/sdcard/watermark.png";
String outputPath = "/sdcard/output.mp4";

VideoWatermark.addWatermark(inputVideoPath, imagePath, outputPath);

确保你已经将视频文件 input.mp4 和水印图像 watermark.png 放置在 /sdcard/ 目录下,并授予应用读写存储权限。

注意事项:

  • 文件路径: 确保输入视频、水印图像和输出视频的文件路径正确。

  • 权限: 需要在 AndroidManifest.xml 文件中添加读写存储权限:

    
    

    并且在运行时动态申请这些权限。

  • 水印位置: overlay 滤镜的参数 5:5 控制水印的位置。根据你的需求调整这些值。可以使用更复杂的表达式,例如 overlay=W-w-10:H-h-10 将水印放置在视频右下角,距离边缘 10 像素。其中 W 和 H 代表视频的宽度和高度,w 和 h 代表水印图像的宽度和高度。

  • 异步执行: FFmpeg 命令的执行可能会耗费较长时间,建议使用 FFmpegKit.executeAsync() 异步执行,避免阻塞主线程。

  • 错误处理: 需要处理 FFmpeg 命令执行失败的情况,例如检查 ReturnCode。

  • 性能: 频繁地进行视频处理可能会消耗大量资源,需要注意性能优化。

总结:

通过使用 FFmpeg 及其 Android 封装库,可以方便地在 Android 应用中为视频添加图像水印。 关键在于正确配置 FFmpeg 命令和处理异步执行以及错误情况。 掌握这些技巧,你就可以轻松地实现视频水印功能,为你的应用增加更多价值。