前言

在音視頻處理領域，開發者常常需要獲取媒體文件的詳細信息，如時長、格式、元數據，以及音視頻流的編碼參數等。這些信息對於媒體管理、轉碼調度、播放控制等場景至關重要。

然而，直接使用 FFmpeg 命令行工具或其原生 API 存在以下挑戰：

• 命令行工具的複雜性：FFmpeg 的命令行參數眾多且複雜，使用不當可能導致錯誤。例如，處理包含空格的文件名時，需要特別注意正確的轉義和引用方式，否則可能導致無法識別文件名的問題。
• 原生 API 的複雜性：FFmpeg 涉及大量的數據結構和函數調用，學習曲線陡峭。
• 內存管理的複雜性：直接操作底層 C 接口，容易引入內存泄漏和安全隱患。
• 維護成本高：需要處理不同版本之間的兼容性問題，增加了開發和維護的難度。

因此，在 Rust 生態中，尋找一種簡潔、安全且高效的方式來集成 FFmpeg，成為開發者的迫切需求。

更好的解決方案

為了解決上述問題，ez-ffmpeg 庫應運而生。它通過 FFI（外部函數接口）調用 FFmpeg 的底層 C 代碼，為 Rust 開發者提供了一個安全且符合人體工學的接口。該庫的設計目標是簡化 FFmpeg 的使用，避免直接操作複雜的原生 API，從而降低開發難度，提高開發效率。

快速上手：用 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::container_info::{get_duration_us, get_format, get_metadata};
use ez_ffmpeg::stream_info::{find_all_stream_infos, find_audio_stream_info, find_video_stream_info};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let file_path = "test.mp4";

    // 獲取媒體文件的時長（微秒）
    let duration = get_duration_us(file_path)?;
    println!("時長: {} 微秒", duration);

    // 獲取媒體文件的格式
    let format = get_format(file_path)?;
    println!("格式: {}", format);

    // 獲取媒體文件的元數據
    let metadata = get_metadata(file_path)?;
    println!("元數據:");
    for (key, value) in metadata {
        println!("{}: {}", key, value);
    }

    // 獲取視頻流信息
    if let Some(video_info) = find_video_stream_info(file_path)? {
        println!("視頻流信息: {:?}", video_info);
    } else {
        println!("未找到視頻流。");
    }

    // 獲取音頻流信息
    if let Some(audio_info) = find_audio_stream_info(file_path)? {
        println!("音頻流信息: {:?}", audio_info);
    } else {
        println!("未找到音頻流。");
    }

    // 獲取所有流信息
    let all_stream_infos = find_all_stream_infos(file_path)?;
    println!("所有流信息:");
    for stream_info in all_stream_infos {
        println!("{:?}", stream_info);
    }

    Ok(())
}

在上述代碼中：

• get_duration_us(file_path)：獲取媒體文件的時長，單位為微秒。
• get_format(file_path)：獲取媒體文件的格式名稱。
• get_metadata(file_path)：獲取媒體文件的元數據信息。
• find_video_stream_info(file_path)：獲取媒體文件中第一個視頻流的信息。
• find_audio_stream_info(file_path)：獲取媒體文件中第一個音頻流的信息。
• find_all_stream_infos(file_path)：獲取媒體文件中所有流的信息。

執行此代碼後，將輸出媒體文件的詳細信息，包括時長、格式、元數據以及各個流的信息。

總結

通過 ez-ffmpeg，Rust 開發者可以在不直接處理 FFmpeg 命令行工具或原生 API 的情況下，安全、高效地獲取媒體文件的信息。這不僅簡化了開發流程，還降低了出錯的風險，使開發者能夠專注於業務邏輯的實現。

🔗 開源項目地址：ez-ffmpeg