当前位置：首页 > article >正文

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

article 2025/3/16 2:39:10

前言

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

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：

brew install ffmpeg

Windows：

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

2. 添加 Rust 依赖

在 Cargo.toml 中引入 ez-ffmpeg：

[dependencies]
ez-ffmpeg = "*"

3. 运行代码

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(())
}