编码与格式 / 系统课时

开发环境准备

开发环境准备

本课以 Ubuntu 22.04 或 24.04 为主线,安装编译工具、FFmpeg 开发库、SDL、播放器和媒体分析工具,并通过一个最小 C 程序验证头文件、链接参数和运行环境。

学习目标

  • 安装音视频开发所需的编译器、构建工具和媒体库
  • 使用 FFmpeg、ffprobe、VLC 与 MediaInfo 完成基础验证
  • 编译并运行一个同时链接 FFmpeg 与 SDL 的最小程序

前置检查

先确认系统架构和基础工具状态。若某个命令提示未找到,后续安装步骤会补齐对应组件。

bash
uname -m
gcc --version | head -n 1
cmake --version | head -n 1

预期输出如下,版本号可能因系统更新而不同。

text
x86_64
gcc (Ubuntu <VERSION>) <VERSION>
cmake version <VERSION>

Apple Silicon 设备的架构通常显示为 arm64,Linux ARM64 常显示为 aarch64。本课命令以 APT 为例,Windows 可使用 Visual Studio 与 vcpkg,macOS 可使用 Xcode Command Line Tools 与 Homebrew。

安装编译工具与媒体组件

下面一次安装 C/C++ 编译工具、CMake、pkg-config、FFmpeg 运行时与开发头文件、SDL2、VLC 和 MediaInfo。

bash
sudo apt update
sudo apt install -y build-essential cmake pkg-config git ffmpeg libavcodec-dev libavformat-dev libavutil-dev libswscale-dev libswresample-dev libsdl2-dev vlc mediainfo

预期结果如下。APT 显示的具体包版本和下载大小会不同。

text
软件包安装完成,命令退出状态为 0。
系统中可使用 ffmpeg、ffprobe、ffplay、vlc、mediainfo、gcc、cmake 和 pkg-config。

FFmpeg 开发包提供头文件与链接库,ffmpeg 包提供命令行工具,SDL2 提供窗口、音频和事件接口。VLC 适合人工播放检查,ffprobe 与 MediaInfo 适合读取编码、封装、时长和码率等元数据。

验证命令行工具

通过版本命令确认工具已进入 PATH,再检查 pkg-config 是否能找到 FFmpeg 与 SDL 的开发描述文件。

bash
ffmpeg -version | head -n 1
ffprobe -version | head -n 1
mediainfo --Version | head -n 1
pkg-config --modversion libavformat sdl2

预期输出中的实际版本号可能不同。

text
ffmpeg version <VERSION> ...
ffprobe version <VERSION> ...
MediaInfo Command line, <VERSION>
<VERSION>
<VERSION>

若 ffmpeg 能运行但 pkg-config 找不到 libavformat,通常说明只安装了运行时,没有安装 libavformat-dev。若 SDL 查询失败,应确认包名为 libsdl2-dev,而不是仅安装 SDL 运行库。

编译最小验证程序

创建 env_check.c。程序读取 FFmpeg 的 libavformat 版本,并初始化 SDL 视频子系统。使用虚拟视频驱动可以避免服务器或容器没有桌面环境时初始化失败。

c
#include <stdio.h>
#include <libavformat/avformat.h>
#include <SDL2/SDL.h>

int main(void) {
    if (SDL_Init(SDL_INIT_VIDEO) != 0) {
        fprintf(stderr, "SDL init failed: %s\n", SDL_GetError());
        return 1;
    }

    /* 同时验证 FFmpeg 符号链接和 SDL 运行时初始化。 */
    printf("FFmpeg avformat: %u\n", avformat_version());
    printf("SDL: %d.%d.%d\n",
           SDL_MAJOR_VERSION, SDL_MINOR_VERSION, SDL_PATCHLEVEL);

    SDL_Quit();
    return 0;
}

预期结果:源码文件保存后不会产生控制台输出,完成下一步编译后才会执行。

text
env_check.c 已保存,等待编译。

保存后执行编译与运行命令:

bash
cc env_check.c -o env_check $(pkg-config --cflags --libs libavformat sdl2)
SDL_VIDEODRIVER=dummy ./env_check

预期输出如下,数值取决于本机安装版本。

text
FFmpeg avformat: <INTEGER>
SDL: <MAJOR>.<MINOR>.<PATCH>

编译通过说明头文件、库文件和 pkg-config 参数有效;程序正常退出说明动态库可被加载,SDL 也能完成最小初始化。

典型失败处理

出现 fatal error: libavformat/avformat.h: No such file or directory 时,检查 libavformat-dev 是否安装。出现 Package sdl2 was not found 时,运行 pkg-config --list-all | grep -i sdl 确认名称,并检查 PKG_CONFIG_PATH 是否被错误覆盖。

出现共享库加载失败时,可执行 ldd ./env_check 查看缺失项。不要先手工复制 .so 文件,应优先修复包安装、运行库路径或容器镜像依赖,否则环境很容易在升级后再次失效。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

开发环境准备

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通