前言

在視頻處理中，幀率（FPS）直接影響視頻的流暢度和設備兼容性。例如，你可能需要將一個 60 FPS 的遊戲錄屏調整為 30 FPS 以適配主流播放平台，或將視頻幀率降低以匹配特定設備的播放要求。傳統上，開發者依賴 FFmpeg 命令行工具完成這類任務，比如 ffmpeg -i input.mp4 -r 30 output.mp4，但這需要掌握複雜的參數，且在批量處理時效率不高。

在 Rust 中，直接通過 FFI（Foreign Function Interface）調用 FFmpeg 的 C 庫是一種選擇，但這種方式複雜且容易出錯。相比之下，ez-ffmpeg 提供了一個簡潔、安全的 Rust 接口，讓開發者無需深入 FFmpeg 命令行或 FFI 細節，就能快速調整視頻幀率。

FFI vs ez-ffmpeg：選擇更優的 Rust 集成方式

FFI 方式的痛點

通過 FFI 調用 FFmpeg 的 C 庫雖然功能全面，但存在明顯短板：

• 複雜性高：需要手動管理 FFmpeg 的結構體和指針，代碼繁瑣。
• 易出錯：Rust 與 C 的內存管理和類型轉換容易引發問題，調試難度大。
• 學習成本高：開發者必須熟悉 FFmpeg 的底層 API，開發效率低。

例如，使用 FFI 調整幀率需要深入理解 AVCodecContext 和 AVFrame 的配置，稍有不慎就可能導致崩潰或意外結果。

ez-ffmpeg 的優勢

ez-ffmpeg 不僅封裝了 FFI 的複雜性，還提供了更符合 Rust 風格的 API：

• 簡潔性：鏈式調用讓代碼更直觀易讀。
• 安全性：自動管理內存，避免泄漏和錯誤。
• 高效性：專注於業務邏輯，快速實現需求。
• 無縫遷移：基本可以從 FFmpeg 命令行無縫遷移過來，學習和遷移門檻極低。如果你已經熟悉 FFmpeg 命令行，ez-ffmpeg 允許你直接將這種知識應用到 Rust 項目中，無需重新學習複雜的底層 API。

例如，調整視頻幀率的代碼幾乎與命令行一一對應：

use ez_ffmpeg::{FfmpegContext, Output};
use ffmpeg_sys_next::AVRational;
​
fn main() -> Result<(), Box<dyn std::error::Error>> {
    FfmpegContext::builder()
        .input("test.mp4") // 對應 -i input.mp4
        .output(Output::from("output.mp4").set_framerate(AVRational { num: 30, den: 1 })) // 對應 -r 30 output.mp4
        .build()?
        .start()?
        .wait()?;
    Ok(())
}

這種設計讓開發者能夠快速上手，輕鬆將現有腳本或工作流程遷移到 Rust 項目中，極大地降低了學習和遷移的門檻。

快速上手：用 Rust 調整視頻幀率

假設你需要將一個 60 FPS 的視頻調整為 30 FPS 以適配平台需求，使用 ez-ffmpeg 只需幾行代碼。

1. 安裝 FFmpeg

macOS：

brew install ffmpeg

Windows：

vcpkg install ffmpeg
# 如果是首次安裝 vcpkg，需設置環境變量 VCPKG_ROOT

2. 添加 Rust 依賴

在 Cargo.toml 中添加：

[dependencies]
ez-ffmpeg = "*"

3. 代碼示例

以下是兩種調整幀率的方法：

方法一：通過 Output 設置幀率

use ez_ffmpeg::{FfmpegContext, Output};
use ffmpeg_sys_next::AVRational;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    FfmpegContext::builder()
        .input("test.mp4") // 輸入文件
        .output(Output::from("output.mp4").set_framerate(AVRational { num: 30, den: 1 })) // 設置輸出幀率為 30 FPS
        .build()?
        .start()?
        .wait()?;
    Ok(())
}

方法二：通過濾鏡設置幀率

use ez_ffmpeg::{FfmpegContext, Output};
​
fn main() -> Result<(), Box<dyn std::error::Error>> {
    FffmpegContext::builder()
        .input("test.mp4") // 輸入文件
        .filter_desc("fps=30") // 使用 "fps" 濾鏡將幀率調整為 30 FPS
        .output(Output::from("output.mp4")) // 輸出文件
        .build()?
        .start()?
        .wait()?;
    Ok(())
}

兩種方法的區別與適用場景

• 方法一（Output 設置幀率） ：

  • 特點：直接指定輸出幀率，簡單明瞭。
  • 適用場景：僅需調整幀率，無其他複雜需求。
  • 優點：代碼量少，適合快速任務。

• 方法二（濾鏡設置幀率） ：

  • 特點：藉助 FFmpeg 濾鏡，支持更多配置。
  • 適用場景：需要同時處理分辨率、裁剪等其他操作。
  • 優點：靈活性強，適合複雜場景。

運行後，將生成一個幀率為 30 FPS 的 output.mp4 文件。

總結

ez-ffmpeg 為 Rust 開發者提供了一個簡潔、安全的方式來調整視頻幀率，避免了 FFmpeg 命令行的繁瑣和 FFI 的複雜性。其最大的優勢在於基本可以從命令行無縫遷移過來，學習和遷移門檻極低，讓開發者能夠快速上手並專注於業務邏輯。

🔗 開源項目地址：ez-ffmpeg