引言：從痛點出發

視頻縮略圖生成是開發者常遇到的需求，比如為視頻網站生成預覽圖，或為內容管理系統提供封面圖。傳統方案大多依賴 FFmpeg 命令行工具，但實際操作時，開發者往往會被複雜的參數配置搞得焦頭爛額：縮放比例怎麼調？時間點怎麼選？幀率和質量如何平衡？不僅容易出錯，還得花時間查文檔、調命令。對於 Rust 開發者來説，有沒有更簡單的方式？答案是肯定的——ez-ffmpeg 這個庫能幫你省時省力，幾行代碼就能搞定這些需求。

FFmpeg 的門檻與 ez-ffmpeg 的解法

FFmpeg 是個功能強大的工具，幾乎能解決所有視頻處理問題，但它的命令行操作對新手不太友好。比如，生成一張縮略圖可能需要寫出這樣的命令：

ffmpeg -i input.mp4 -vf "scale=160:-1" -frames:v 1 -q:v 2 thumbnail.jpg

參數多、規則雜，還要手動處理文件路徑和錯誤，稍微不注意就可能失敗。而 ez-ffmpeg 是一個專為 Rust 設計的庫，它把 FFmpeg 的複雜操作封裝成直觀的 API，不僅代碼更簡潔，還能利用 Rust 的內存安全特性，避免資源泄露等問題。接下來，我們通過實際例子看看它有多好用。

快速上手：用 Rust 生成視頻縮略圖

1. 準備環境：安裝 FFmpeg

在使用 ez-ffmpeg 之前，需要確保系統中已安裝 FFmpeg：

• macOS：

  brew install ffmpeg

• Windows（推薦用 vcpkg）：

  vcpkg install ffmpeg
  # 如果是首次使用 vcpkg，別忘了設置環境變量 VCPKG_ROOT

安裝完成後，運行 ffmpeg -version 檢查是否成功。

2. 項目配置：添加依賴

在 Rust 項目中，打開 Cargo.toml，添加以下依賴：

[dependencies]
ez-ffmpeg = "0.1"  # 建議指定版本號，避免不必要的更新問題

3. 單張縮略圖生成

假如我們需要從視頻中提取一張縮略圖，寬度固定為 160 像素，高度自適應，同時保證高質量輸出，代碼如下：

use ez_ffmpeg::{FfmpegContext, Output};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    FfmpegContext::builder()
        .input("input.mp4") // 輸入視頻文件
        .filter_desc("scale='min(160,iw)':-1") // 寬度 160，高度按比例調整
        .output(
            Output::from("thumbnail.jpg")
                .set_max_video_frames(1) // 只取一幀
                .set_video_quality(2), // 質量設置為 2（數值越小越好）
        )
        .build()?
        .start()?
        .wait()?;
    Ok(())
}

代碼解析：

• filter_desc("scale='min(160,iw)':-1")：使用 FFmpeg 的 scale 濾鏡，寬度固定為 160 像素，高度根據視頻原始比例自動計算。
• set_max_video_frames(1)：限制只提取一幀，適合生成單張縮略圖。
• set_video_quality(2)：設置輸出質量，2 表示較高品質（範圍 2-31，2 是推薦值）。

運行後，當前目錄下會生成 thumbnail.jpg，效果立竿見影。

4. 多張縮略圖生成

如果需要從視頻中每隔 10 秒提取一張縮略圖，比如用於視頻預覽，可以稍作調整：

use ez_ffmpeg::{FfmpegContext, Output};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    FfmpegContext::builder()
        .input("input.mp4") // 輸入視頻文件
        .filter_desc("select='not(mod(t,10))',scale='min(160,iw)':-1") // 每 10 秒取一幀並縮放
        .output(
            Output::from("thumbnail_%03d.jpg") // 輸出文件名帶序號
                .set_video_quality(2), // 設置高質量
        )
        .build()?
        .start()?
        .wait()?;
    Ok(())
}

代碼解析：

• select='not(mod(t,10))'：每隔 10 秒選擇一幀，t 是時間戳（單位：秒）。
• scale='min(160,iw)':-1：同樣將寬度縮放到 160 像素。
• thumbnail_%03d.jpg：輸出文件名會自動遞增，如 thumbnail_001.jpg、thumbnail_002.jpg。

運行後，你會得到一系列縮略圖，方便批量處理。

還能做什麼？

ez-ffmpeg 的功能遠不止於此。你可以通過調整參數實現更多需求，比如：

• 修改幀率（用 set_frame_rate）。
• 轉換輸出格式（比如 PNG、WebP）。

想了解更多用法，可以看看官方文檔，裏面有詳細的 API 説明和示例。

總結：簡單又高效

對於 Rust 開發者來説，ez-ffmpeg 是個實用的工具，它把 FFmpeg 的複雜命令行操作簡化成了直觀的代碼調用。無論是生成單張縮略圖，還是批量處理多張圖片，都能快速上手，省下不少調試時間。如果你也在為視頻處理髮愁，不妨試試這個庫。

🔗 感興趣的話，可以訪問：ez-ffmpeg GitHub 倉庫