Rusty FFmpeg 项目使用教程

Rusty FFmpeg 项目使用教程

rusty_ffmpeg FFI bindings for FFmpeg inner libraries. 项目地址: https://gitcode.com/gh_mirrors/ru/rusty_ffmpeg

1. 项目目录结构及介绍

Rusty FFmpeg 是一个用于生成 FFmpeg 内部库的跨平台 FFI (Foreign Function Interface) 绑定的项目。以下是项目的目录结构及其简要介绍：

rusty_ffmpeg/
├── examples/             # 示例代码目录
├── src/                  # 源代码目录
│   ├── build.rs          # 构建脚本
│   ├── lib.rs            # 库的主要文件
│   └── ...               # 其他源代码文件
├── .github/              # GitHub 工作流和配置文件
│   └── workflows/        # CI/CD 工作流文件
├── .gitignore            # Git 忽略文件
├── Cargo.toml            # Rust 项目配置文件
├── LICENSE               # 项目许可证文件
└── README.md             # 项目自述文件

• examples/：包含了一些使用 Rusty FFmpeg 的示例代码。
• src/：源代码目录，包含了构建 Rust 绑定和链接 FFmpeg 库的主要逻辑。
  • build.rs：构建脚本，用于配置项目的构建过程。
  • lib.rs：库的主要文件，定义了对外提供的功能。
• .github/：包含了 GitHub 的工作流和配置文件，用于自动化测试和发布等操作。
• .gitignore：指定 Git 忽略的文件和目录。
• Cargo.toml：Rust 项目配置文件，定义了项目的依赖、构建配置等信息。
• LICENSE：项目使用的许可证信息。
• README.md：项目自述文件，介绍了项目的相关信息和使用方法。

2. 项目的启动文件介绍

项目的启动主要通过 Cargo.toml 文件进行配置。Cargo.toml 是 Rust 项目的配置文件，位于项目的根目录。以下是 Cargo.toml 的基本结构：

[package]
name = "rusty_ffmpeg"
version = "0.16.1+ffmpeg.7.0"
edition = "2021"

[dependencies]

[build-dependencies]

[dev-dependencies]

[lib]
crate-type = ["cdylib"]

[features]
link_system_ffmpeg = []
link_vcpkg_ffmpeg = []
ffmpeg4 = []
ffmpeg5 = []
ffmpeg6 = []
ffmpeg7 = []

在这个文件中，你可以定义项目的名称、版本、依赖项以及项目的特性（features）。例如，通过特性 link_system_ffmpeg 和 link_vcpkg_ffmpeg 可以指定链接到系统安装的 FFmpeg 库或通过 vcpkg 管理的 FFmpeg 库。

3. 项目的配置文件介绍

项目的配置主要通过环境变量来实现。以下是一些主要的环境变量及其用途：

• FFMPEG_PKG_CONFIG_PATH：当使用系统包管理器安装 FFmpeg 时，设置此环境变量指向 FFmpeg 的 pkg-config 目录。
• FFMPEG_DLL_PATH：动态链接时，设置此环境变量指向 FFmpeg 的 DLL 或 so 文件路径。
• FFMPEG_LIBS_DIR：静态链接时，设置此环境变量指向 FFmpeg 预编译库的目录。
• FFMPEG_INCLUDE_DIR：编译时绑定生成，设置此环境变量指向 FFmpeg 头文件的路径。
• FFMPEG_BINDING_PATH：使用预编译的绑定文件，设置此环境变量指向预编译的绑定文件路径。

通过正确设置这些环境变量，可以确保 Rusty FFmpeg 能够正确链接和绑定 FFmpeg 库。

rusty_ffmpeg FFI bindings for FFmpeg inner libraries. 项目地址: https://gitcode.com/gh_mirrors/ru/rusty_ffmpeg