Android实现视频加水印（附带源码）

Android 实现视频加水印项目详解

目录

1. 项目背景与意义

2. 相关技术及知识储备
   2.1 视频格式及编码基础
   2.2 FFmpeg 及其在 Android 上的应用
   2.3 Android 多媒体处理原理
   2.4 水印技术原理
   2.5 常见问题与注意事项

3. 项目整体架构与实现思路
   3.1 项目架构图
   3.2 项目流程及模块划分
   3.3 关键技术点详解

4. 详细实现代码及注释说明
   4.1 项目主要代码（Kotlin 版）
   4.2 布局文件及资源说明
   4.3 工具类与辅助方法

5. 代码解读与方法功能说明
   5.1 核心方法解读
   5.2 FFmpeg 命令详解

6. 项目调试、测试与常见问题
   6.1 调试方法与日志输出
   6.2 常见问题与解决方案

7. 项目总结与未来展望
   7.1 项目总结
   7.2 未来扩展方向

8. 参考资料与学习资源

9. 附录

1. 项目背景与意义

随着移动互联网的迅速发展，短视频、直播及视频分享等应用迅速普及，视频内容的原创性和版权保护变得越来越重要。视频加水印技术在各类场景下发挥着不可替代的作用，例如：

• 版权保护：为原创视频添加专属标识，防止盗播、盗用；

• 品牌推广：在视频中叠加企业 Logo 或品牌名称，提升品牌曝光度；

• 信息标注：在视频上显示时间戳、地理位置信息或其他标识，便于信息追溯；

• 安全防伪：在视频中嵌入加密水印，防止恶意篡改。

本项目旨在借助 Android 平台与 FFmpeg 开源工具，实现一个完整的“视频加水印”功能，从视频文件读取、解码、处理、合成到输出整个流程均在本地完成。通过这一项目，不仅可以帮助开发者了解视频处理的底层原理，还能为后续的多媒体应用开发提供技术支持。

2. 相关技术及知识储备

在深入项目实现之前，有必要对项目所涉及的相关技术和基础知识做一个系统的介绍。

2.1 视频格式及编码基础

视频文件由视频流、音频流以及封装信息组成。常见的封装格式包括 MP4、AVI、MKV 等，而视频编码格式则有 H.264、H.265、VP8/VP9 等。编码原理涉及帧间预测、运动补偿、变换编码和熵编码等技术，是视频压缩技术的核心。理解这些基本原理有助于我们更好地把握视频加水印的处理流程。

• 关键帧与非关键帧
  关键帧（I 帧）包含完整图像信息，而非关键帧（P 帧、B 帧）则依赖前后帧数据，理解这一点对于视频解码与处理非常重要。

• 帧率与码率
  帧率决定视频的流畅度，码率则影响视频质量与体积，处理时必须确保输出视频的这些参数与原视频匹配，避免音视频不同步。

2.2 FFmpeg 及其在 Android 上的应用

FFmpeg 是一款功能强大的多媒体处理库，支持音视频编解码、转码、合成、滤镜处理等操作。在 Android 中，使用 FFmpeg 常采用两种方式：

1. 命令行调用
   通过封装好的 Android 库（如 ffmpeg-kit、Mobile-FFmpeg 等）直接调用 FFmpeg 命令行。命令行方式简单易用，适合大部分视频处理任务。

2. JNI 调用
   将 FFmpeg 库编译成动态库，并通过 JNI 调用底层 API，性能较高但开发难度较大。

本项目采用命令行调用方式，通过 ffmpeg-kit 实现视频加水印操作，其核心命令示例如下：

ffmpeg -i input.mp4 -vf "drawtext=text='Hello World':fontcolor=white:fontsize=36:x=10:y=H-th-10" -codec:a copy output.mp4

该命令将视频 input.mp4 中叠加文字水印“Hello World”，并保留音频流，生成输出视频 output.mp4。

2.3 Android 多媒体处理原理

Android 为多媒体处理提供了一系列 API，包括：

• MediaExtractor：用于分离视频和音频流，提取数据。

• MediaCodec：提供硬件或软件的视频、音频编解码功能。

• MediaMuxer：将处理后的音视频流封装成新文件。

通过这些组件，我们可以实现对视频的解码、逐帧处理和重新编码等操作。但相较于 FFmpeg，这些 API 的调用较为繁琐，且对底层细节要求较高，因此在本项目中主要借助 FFmpeg 完成视频处理任务。

2.4 水印技术原理

视频水印主要有两种实现方式：

1. 静态水印
   在所有视频帧上叠加相同的图像或文字水印。实现简单，适用于大部分版权保护和品牌宣传场景。

2. 动态水印
   根据视频播放进度或其他条件，动态改变水印的内容或位置。实现难度较高，但能满足特定需求，如时间戳或动态广告。

本项目主要实现静态水印的添加，同时也讨论了动态水印的扩展思路。

2.5 常见问题与注意事项

在视频处理过程中，可能会遇到如下问题：

• 音视频不同步
  需注意处理过程中保持时间戳的一致性。

• 命令拼接错误
  生成 FFmpeg 命令时，注意字符串拼接和参数格式，防止因格式问题导致命令执行失败。

• 权限问题
  Android 6.0 及以上版本需要动态申请存储权限。

• 字符编码问题
  当水印文字包含中文或特殊字符时，需配置合适的字体文件，防止乱码。

3. 项目整体架构与实现思路

在明确了相关基础知识后，下面详细介绍项目的整体架构和实现思路。

3.1 项目架构图

整个项目可分为如下几个主要模块：

• 用户界面模块
  包含视频选择、参数设置、水印预览、结果展示等交互界面。

• 视频处理模块
  负责调用 FFmpeg 对视频进行解码、处理、加水印及重新封装。

• 数据管理模块
  用于处理文件路径、临时缓存文件及日志记录。

• 工具辅助模块
  包含命令构造工具、错误处理与日志输出、权限申请等功能。

（上图为示意图，实际项目中可采用 UML 图工具绘制详细结构图）

3.2 项目流程及模块划分

整个视频加水印的流程可概括为以下几个步骤：

1. 视频选择与预览
   用户通过文件选择器选取本地视频，并在界面上预览视频封面或关键帧。

2. 水印参数配置
   用户输入文字或选择图片作为水印，设置水印的位置（如左上、右下等）、透明度、字体大小等参数。

3. 命令构造
   根据用户输入和视频文件参数，动态构造 FFmpeg 命令行字符串。常用命令包括：

   • drawtext：添加文字水印；

   • overlay：添加图片水印；

   • scale：调整视频分辨率（必要时）。

4. 视频处理执行
   通过 ffmpeg-kit 的异步接口执行命令，实时监听处理进度，并在完成后通知用户。

5. 结果输出与查看
   生成的视频文件存放于指定路径，用户可点击预览、分享或删除。

3.3 关键技术点详解

• FFmpeg 命令构造
  构造命令时需要考虑命令参数的顺序、引号的嵌套及特殊字符的转义。例如，当水印文字包含空格或中文时，需保证命令字符串格式正确。

• 异步任务管理
  视频处理可能耗时较长，因此必须在后台线程执行，同时结合 Handler 或 runOnUiThread 方法更新 UI 界面。

• 权限管理与文件路径处理
  Android 动态权限申请和 Uri 转换是必须解决的问题。通过工具类统一处理文件路径和存储权限申请，提高代码复用性和健壮性。

• 错误捕获与日志记录
  针对 FFmpeg 命令返回值进行判断，并结合日志系统记录调试信息，方便后续维护和问题排查。

4. 详细实现代码及注释说明

下面将以 Kotlin 语言为例，详细介绍项目的核心代码，并在代码中附上丰富的注释，便于开发者理解每一步的处理逻辑。

4.1 项目主要代码（Kotlin 版）

package com.example.videowatermark

import android.Manifest
import android.app.Activity
import android.content.Intent
import android.content.pm.PackageManager
import android.net.Uri
import android.os.Bundle
import android.os.Environment
import android.util.Log
import android.widget.*
import androidx.appcompat.app.AppCompatActivity
import androidx.core.app.ActivityCompat
import com.arthenica.ffmpegkit.FFmpegKit
import com.arthenica.ffmpegkit.ReturnCode
import java.io.File
import java.text.SimpleDateFormat
import java.util.*

/**
 * MainActivity 为项目的入口，主要实现以下功能：
 * 1. 选择视频文件
 * 2. 配置水印参数（支持文字水印，本例仅展示文字水印处理）
 * 3. 构造 FFmpeg 命令并调用 ffmpeg-kit 进行视频处理
 * 4. 处理完成后展示输出文件路径并提示用户
 */
class MainActivity : AppCompatActivity() {

    // 定义控件变量
    private lateinit var btnSelectVideo: Button
    private lateinit var btnProcessVideo: Button
    private lateinit var edtWatermark: EditText
    private lateinit var txtOutputPath: TextView

    // 存储选取的视频 URI
    private var videoUri: Uri? = null

    // 请求码
    companion object {
        private const val REQUEST_VIDEO_PICK = 1001
        private const val REQUEST_PERMISSION = 1002
        private const val TAG = "MainActivity"
    }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        // 加载布局文件
        setContentView(R.layout.activity_main)

        // 初始化控件
        btnSelectVideo = findViewById(R.id.btnSelectVideo)
        btnProcessVideo = findViewById(R.id.btnProcessVideo)
        edtWatermark = findViewById(R.id.edtWatermark)
        txtOutputPath = findViewById(R.id.txtOutputPath)

        // 检查存储权限（Android 6.0+）
        if (ActivityCompat.checkSelfPermission(
                this,
                Manifest.permission.WRITE_EXTERNAL_STORAGE
            ) != PackageManager.PERMISSION_GRANTED
        ) {
            ActivityCompat.requestPermissions(
                this,
                arrayOf(Manifest.permission.WRITE_EXTERNAL_STORAGE),
                REQUEST_PERMISSION
            )
        }

        // 视频选择按钮点击事件
        btnSelectVideo.setOnClickListener {
            selectVideoFromGallery()
        }

        // 处理视频按钮点击事件
        btnProcessVideo.setOnClickListener {
            val watermarkText = edtWatermark.text.toString().trim()
            if (videoUri == null) {
                Toast.makeText(this, "请先选择视频文件", Toast.LENGTH_SHORT).show()
                return@setOnClickListener
            }
            if (watermarkText.isEmpty()) {
                Toast.makeText(this, "请输入水印文字", Toast.LENGTH_SHORT).show()
                return@setOnClickListener
            }
            processVideoWithWatermark(videoUri!!, watermarkText)
        }
    }

    /**
     * 调用系统文件选择器选择视频文件
     */
    private fun selectVideoFromGallery() {
        val intent = Intent(Intent.ACTION_GET_CONTENT)
        intent.type = "video/*"
        startActivityForResult(intent, REQUEST_VIDEO_PICK)
    }

    override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
        if (requestCode == REQUEST_VIDEO_PICK && resultCode == Activity.RESULT_OK) {
            data?.data?.let {
                videoUri = it
                Toast.makeText(this, "视频选择成功", Toast.LENGTH_SHORT).show()
            }
        }
        super.onActivityResult(requestCode, resultCode, data)
    }

    /**
     * 利用 ffmpeg-kit 调用 FFmpeg 命令进行视频加水印处理
     *
     * @param uri 选中的视频文件 Uri
     * @param watermark 水印文字内容
     */
    private fun processVideoWithWatermark(uri: Uri, watermark: String) {
        // 获取视频文件真实路径
        val inputPath = FileUtils.getPathFromUri(this, uri)
        if (inputPath == null) {
            Toast.makeText(this, "无法获取视频路径", Toast.LENGTH_SHORT).show()
            return
        }
        // 定义输出视频文件路径（存放于缓存目录，实际项目中可根据需要调整）
        val outputPath = File(
            getExternalFilesDir(Environment.DIRECTORY_MOVIES),
            "output_${System.currentTimeMillis()}.mp4"
        ).absolutePath

        // 构造 FFmpeg 命令字符串
        // 命令说明：
        // - "-i" 后跟输入文件路径
        // - "-vf" 后跟视频滤镜参数，本例采用 drawtext 滤镜添加水印文字
        //   其中 "drawtext=text='...'" 定义水印文字，
        //   "fontcolor" 指定字体颜色，
        //   "fontsize" 指定字体大小，
        //   "x=10:y=H-th-10" 指定水印位置（左下角，离底边 10 像素，离左边 10 像素）
        // - "-codec:a copy" 保留原音频流
        // - 最后一个参数为输出文件路径
        val command = arrayOf(
            "-i", "\"$inputPath\"",
            "-vf", "\"drawtext=text='$watermark':fontcolor=white:fontsize=36:x=10:y=H-th-10\"",
            "-codec:a", "copy",
            "\"$outputPath\""
        ).joinToString(" ")

        Log.d(TAG, "执行的 FFmpeg 命令: $command")

        // 异步执行 FFmpeg 命令，避免阻塞 UI 线程
        FFmpegKit.executeAsync(command) { session ->
            val returnCode = session.returnCode
            runOnUiThread {
                if (ReturnCode.isSuccess(returnCode)) {
                    // 处理成功
                    txtOutputPath.text = "输出文件路径：$outputPath"
                    Toast.makeText(this, "视频加水印成功！", Toast.LENGTH_LONG).show()
                } else {
                    // 处理失败
                    Toast.makeText(this, "视频处理失败，请检查日志", Toast.LENGTH_LONG).show()
                }
            }
        }
    }

    // 权限请求结果回调
    override fun onRequestPermissionsResult(
        requestCode: Int, permissions: Array<out String>, grantResults: IntArray
    ) {
        if (requestCode == REQUEST_PERMISSION) {
            if (grantResults.isNotEmpty() && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                Toast.makeText(this, "权限获取成功", Toast.LENGTH_SHORT).show()
            } else {
                Toast.makeText(this, "权限未获取，部分功能可能无法使用", Toast.LENGTH_SHORT).show()
            }
        }
        super.onRequestPermissionsResult(requestCode, permissions, grantResults)
    }
}

4.2 布局文件及资源说明

在 res/layout/activity_main.xml 中，主要包含以下控件：

• btnSelectVideo：用于选择视频文件的按钮

• edtWatermark：用户输入水印文字的编辑框

• btnProcessVideo：开始视频处理的按钮

• txtOutputPath：显示处理后视频输出路径的文本视图

示例布局文件如下（部分简化版）：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:padding="16dp"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <Button
        android:id="@+id/btnSelectVideo"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="选择视频" />

    <EditText
        android:id="@+id/edtWatermark"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:hint="请输入水印文字" />

    <Button
        android:id="@+id/btnProcessVideo"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="开始加水印" />

    <TextView
        android:id="@+id/txtOutputPath"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="输出文件路径显示区域"
        android:textColor="@android:color/black" />

</LinearLayout>

4.3 工具类与辅助方法

为了便于处理 Android 中 URI 到文件路径的转换，我们可以封装一个工具类 FileUtils：

package com.example.videowatermark

import android.content.Context
import android.database.Cursor
import android.net.Uri
import android.provider.MediaStore

/**
 * FileUtils 工具类
 * 用于处理 Uri 转文件路径的操作
 */
object FileUtils {

    /**
     * 从 Uri 中获取真实文件路径
     *
     * @param context 上下文
     * @param uri 文件的 Uri
     * @return 文件路径字符串，若获取失败返回 null
     */
    fun getPathFromUri(context: Context, uri: Uri): String? {
        val projection = arrayOf(MediaStore.Video.Media.DATA)
        var path: String? = null
        val cursor: Cursor? = context.contentResolver.query(uri, projection, null, null, null)
        if (cursor != null) {
            val columnIndex = cursor.getColumnIndexOrThrow(MediaStore.Video.Media.DATA)
            if (cursor.moveToFirst()) {
                path = cursor.getString(columnIndex)
            }
            cursor.close()
        }
        return path
    }
}

5. 代码解读与方法功能说明

在此部分，我们对项目代码中的各个核心方法及实现原理进行详细解析，帮助你理解整个处理流程。

5.1 核心方法解读

• selectVideoFromGallery()
  该方法通过 Intent 调用系统的文件选择器，允许用户选择本地视频文件，并在 onActivityResult() 中回调获取视频的 Uri。这样既能支持各种视频文件格式，又方便后续处理。

• processVideoWithWatermark()
  核心方法：

  1. 通过 FileUtils 工具类将选中的 Uri 转换为真实文件路径。

  2. 根据当前时间生成输出文件路径，保证文件名不重复。

  3. 构造 FFmpeg 命令字符串，利用 drawtext 滤镜实现文字水印的添加。命令中：

     • -i 后接输入文件路径；

     • -vf 指定视频滤镜参数；

     • drawtext=text='水印内容' 定义水印内容，同时可设置字体颜色、大小及位置；

     • -codec:a copy 保留原音频不变。

  4. 异步调用 FFmpegKit.executeAsync() 执行命令，并在回调中判断返回码，根据处理结果更新 UI。

• onRequestPermissionsResult()
  处理 Android 动态权限申请的回调，确保在执行视频处理前，应用具备必要的存储权限。

5.2 FFmpeg 命令详解

构造的 FFmpeg 命令字符串为：

-i "输入文件路径" -vf "drawtext=text='水印文字':fontcolor=white:fontsize=36:x=10:y=H-th-10" -codec:a copy "输出文件路径"

解析如下：

• -i "输入文件路径"
  指定需要处理的视频文件，注意路径需加引号，防止路径中有空格导致错误。

• -vf "drawtext=..."

  • drawtext 滤镜用于在视频帧上绘制文字；

  • text='水印文字' 定义需要添加的水印内容，支持中文和特殊字符，但需要注意字体支持问题；

  • fontcolor=white 指定文字颜色为白色；

  • fontsize=36 设置文字大小为 36 像素；

  • x=10:y=H-th-10 定义文字在视频帧上的位置，x 轴距离左边 10 像素，y 轴距离视频高度减去文字高度再减 10 像素，即底部左侧。

• -codec:a copy
  保留原视频的音频流，避免重新编码音频导致时间不同步或质量下降。

• "输出文件路径"
  指定处理后视频文件的保存位置。

6. 项目调试、测试与常见问题

在实际开发和测试过程中，可能会遇到各种问题。以下是一些常见问题及其解决方法：

6.1 调试方法与日志输出

• 日志输出
  使用 Log 类记录 FFmpeg 命令执行过程中的关键信息，便于定位问题。

• 断点调试
  使用 Android Studio 的断点调试功能，逐步执行关键方法（如 URI 转换、命令构造、异步任务回调）。

• FFmpeg 返回码
  根据 FFmpeg 返回码判断处理是否成功，常见返回码：

  • 成功：ReturnCode.isSuccess()

  • 取消：ReturnCode.isCancel()

  • 失败：ReturnCode.isError()，需查阅 FFmpegKit 文档获取详细信息。

6.2 常见问题与解决方案

7. 项目总结与未来展望

7.1 项目总结

本项目实现了在 Android 平台上通过 FFmpeg 实现视频加水印的完整流程，主要成果包括：

• 技术提升
  通过项目实践，深入理解了视频编解码、滤镜处理及 FFmpeg 命令行调用原理，同时熟悉了 Android 多媒体处理 API 和存储权限管理等技术细节。

• 模块化设计思想
  项目将视频选择、命令构造、异步处理、错误捕捉等功能模块化，有助于后期扩展与维护，并能灵活应对不同的处理需求。

• 用户体验与健壮性
  在项目中，通过日志记录、错误提示和异步任务管理，确保在处理过程中能及时反馈状态，提升用户体验。

7.2 未来扩展方向

为进一步提升项目实用性和功能丰富度，未来可从以下几个方向进行扩展：

1. 图片水印支持
   除了文字水印，可增加图片水印功能，利用 FFmpeg 的 overlay 滤镜实现图片与视频帧的叠加，允许用户自定义水印图片及位置。

2. 动态水印
   根据视频播放进度、用户输入或其他动态数据，实时更新水印内容，如添加动态时间戳、滚动字幕等。

3. 批量处理与任务管理
   支持一次性处理多个视频文件，提供任务队列与进度管理界面，提高生产效率。

4. 实时预览与编辑
   集成 OpenGL ES 渲染技术，实现水印效果的实时预览与编辑，用户可在添加前调整水印样式、位置、透明度等参数。

5. 云端处理与分享
   增加视频上传与云端处理功能，将本地视频处理与云端存储、分享结合，满足社交平台和视频编辑应用的需求。

8. 参考资料与学习资源

为了进一步掌握相关技术，建议参考以下资料与官方文档：

• FFmpeg 官方文档
  详细介绍 FFmpeg 的使用方法、滤镜参数以及各项功能配置。

• ffmpeg-kit GitHub 主页
  Android 上使用 FFmpeg 的封装库，包含详细的 API 说明和示例代码。

• Android Developers 官方文档
  关于 MediaExtractor、MediaCodec、MediaMuxer 等多媒体 API 的使用说明。

• Android 存储权限指南
  讲解如何在 Android 中申请动态权限及处理权限回调。

• 视频编码基础知识
  可在知乎、掘金等社区查找相关视频编码及滤镜处理的技术文章，帮助深入理解底层原理。

总结

本篇文章系统介绍了 Android 实现视频加水印的完整流程，内容涵盖：

• 项目背景与意义：详细说明了视频加水印在版权保护、品牌推广等方面的重要性。

• 相关知识储备：从视频编码基础、FFmpeg 的使用，到 Android 多媒体处理和水印技术的核心原理进行了详细讲解。

• 项目整体架构与实现思路：通过架构图、流程划分及关键技术点解析，让开发者清楚每个模块的职责和协作关系。

• 详细实现代码及注释：提供了完整的 Kotlin 示例代码，包含 UI、FFmpeg 命令构造、权限管理、工具类封装等各个环节，并附有详细注释，便于学习和复用。

• 代码解读与方法说明：对核心方法、命令参数及 FFmpeg 调用机制进行了全面解析，帮助读者深入理解每一步的原理。

• 调试与常见问题：总结了项目调试方法和常见问题的解决方案，帮助开发者在实践中快速排查故障。

• 项目总结与未来展望：总结了项目成果，并针对图片水印、动态水印、批量处理、实时预览等方向提出了扩展思路，为后续开发提供参考。

通过本文的深入讲解，希望能帮助你全面掌握 Android 视频加水印技术，不仅能用于博客分享，也能作为项目开发的实战指南。未来你可以根据具体需求，进一步扩展和完善该项目，实现更多高级功能。