三分钟掌握音视频处理 | 在 Rust 中优雅地集成 FFmpeg

Yeauty2025-03-12 13:37

前言

音视频处理看似高深莫测，但在开发中，我们或多或少都会遇到相关需求，比如视频格式转换、剪辑、添加水印、音频提取等。

FFmpeg 作为行业标准，几乎无所不能，很多流行的软件（如 VLC、YouTube、OBS）都依赖它。然而，FFmpeg 也有让开发者头疼的地方：

入门门槛高，需要理解复用/解复用、编解码、像素格式、采样率等概念。
C 语言实现 ，直接调用时容易踩内存管理的坑，稍有不慎就可能引发内存泄漏、非法访问、程序崩溃等问题。
代码底层且维护难，稍不留神就陷入调试噩梦。

Rust 以 内存安全、性能强大 著称，那么在 Rust 里，有没有一种简单、安全、且符合我们习惯的方式来使用 FFmpeg 呢？

ez-ffmpeg：让 Rust 程序员优雅使用 FFmpeg

ez-ffmpeg 让你可以像写普通 Rust 代码一样，通过链式调用创建和执行 FFmpeg 任务。

它使用 FFI 调用 FFmpeg 的底层 C 代码，并自动管理内存，让你无需担心 C 语言常见的内存安全问题。

快速上手：用 Rust 进行格式转换

假设我们需要将一个视频（或音频、图片）转换格式，使用 ez-ffmpeg 只需几行代码：

1. 安装 FFmpeg

如果你的环境尚未安装 FFmpeg，可以按以下方式安装：

macOS：

bash 复制代码

brew install ffmpeg

Windows：

bash 复制代码

vcpkg install ffmpeg
# 如果是第一次安装 vcpkg，还需设置环境变量 VCPKG_ROOT

2. 添加 Rust 依赖

在 Cargo.toml 中引入 ez-ffmpeg：

toml 复制代码

[dependencies]
ez-ffmpeg = "*"

3. 运行代码

rust 复制代码

use ez_ffmpeg::FfmpegContext;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // 1. 构建 FFmpeg 上下文
    let context = FfmpegContext::builder()
        .input("input.mp4")   // 输入文件
        .output("output.mov") // 输出文件
        .build()?;

    // 2. 启动并等待任务完成
    context.start()?.wait()?;
    Ok(())
}

就这么简单！你只需关注输入和输出 ，ez-ffmpeg 便可完成格式转换。

不仅仅是格式转换

ez-ffmpeg 还能轻松实现 视频剪辑、音视频提取、添加滤镜、RTMP 推流、GPU 加速 等功能。

查看官方示例：examples

总结

相比 FFmpeg 的命令行方式，ez-ffmpeg 让 Rust 开发者可以无缝转换 FFmpeg 命令到代码，而无需额外学习 C 语言。

此外，它支持 自定义 Filter 和输入/输出，直接用 Rust 实现，摆脱了 C 语言扩展的复杂性，也避免了 FFmpeg 编译的痛苦。

🔗 开源项目地址 ：ez-ffmpeg