在Android应用中为视频添加图像水印-java教程-PHP中文网

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

碧海醫心

发布： 2025-10-28 13:14:01

原创

627人浏览过

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

本文将介绍如何在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/ 目录下，并授予应用读写存储权限。

图像转图像AI

利用AI轻松变形、风格化和重绘任何图像

查看详情

注意事项：

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

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

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

登录后复制

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

水印位置： overlay 滤镜的参数 5:5 控制水印的位置。根据你的需求调整这些值。可以使用更复杂的表达式，例如 overlay=W-w-10:H-h-10 将水印放置在视频右下角，距离边缘 10 像素。其中 W 和 H 代表视频的宽度和高度，w 和 h 代表水印图像的宽度和高度。
异步执行： FFmpeg 命令的执行可能会耗费较长时间，建议使用 FFmpegKit.executeAsync() 异步执行，避免阻塞主线程。
错误处理： 需要处理 FFmpeg 命令执行失败的情况，例如检查 ReturnCode。
性能： 频繁地进行视频处理可能会消耗大量资源，需要注意性能优化。