📚 课程目录第2章环境搭建与工具准备

2. 环境搭建与工具准备

说实话，我见过太多人一上来就写管道，结果跑不起来。为什么？环境没配好。GStreamer 的依赖链其实挺长的，少一个插件包，管道就罢工。这一章，咱们先把地基打牢。

2.1 安装 GStreamer 核心库

Ubuntu 和 Debian 的包管理很成熟。我个人习惯用 apt 一把梭，但要注意选对版本。GStreamer 1.0 是当前主流，别装成 0.10 的老古董。

# 更新索引
sudo apt update

# 安装核心运行时和开发头文件
sudo apt install -y \
    libgstreamer1.0-0 \
    libgstreamer1.0-dev \
    gstreamer1.0-tools \
    gstreamer1.0-plugins-base \
    gstreamer1.0-plugins-good \
    gstreamer1.0-plugins-bad \
    gstreamer1.0-plugins-ugly \
    gstreamer1.0-libav \
    libgstreamer-plugins-base1.0-dev

我的经验： 别偷懒只装 gstreamer1.0-tools。我踩过坑——调试时发现缺了 videotestsrc，就是因为没装 -base 插件包。建议上面这行一次性装完。

2.2 验证安装：gst-launch-1.0 初体验

装完第一件事，跑个最简单的管道。看看能不能出画面。

gst-launch-1.0 videotestsrc ! autovideosink

如果弹出一个彩色条纹跳动的窗口，恭喜你，环境通了。如果报错，别慌。我遇到过最常见的问题是 autovideosink 找不到显示后端。这时候可以指定 ximagesink 或 waylandsink：

# 试试 X11 后端
gst-launch-1.0 videotestsrc ! ximagesink

# 或者用 Wayland
gst-launch-1.0 videotestsrc ! waylandsink

注意： 如果你在 SSH 远程终端里跑，没有桌面环境，autovideosink 会直接报错。这时候可以用 fakesink 做无头测试：gst-launch-1.0 videotestsrc ! fakesink。它只消耗数据，不渲染画面。

2.3 核心工具链：gst-inspect-1.0

这个工具我几乎天天用。它能告诉你系统里有哪些元素、每个元素的参数是什么、Pad 怎么接。说白了，它就是 GStreamer 的「活字典」。

2.3.1 查看所有已安装的元素

gst-inspect-1.0 | head -30

输出会列出所有插件和元素。你可以用 grep 过滤：

# 只看视频相关的元素
gst-inspect-1.0 | grep -i video

2.3.2 查看单个元素的详细信息

gst-inspect-1.0 videotestsrc

输出会包含：

Pad 模板： 源 Pad 输出什么格式的视频
属性列表： 比如 pattern、is-live 等
信号和动作： 高级用法时会用到

举个例子，我想让测试画面变成雪花点：

gst-launch-1.0 videotestsrc pattern=2 ! autovideosink

为什么 pattern=2 是雪花？因为 gst-inspect-1.0 videotestsrc 里写了：pattern: 0=smpTE, 1=color bars, 2=snow...。你看，查一下文档就明白了。

2.4 其他实用工具

工具名	作用	常用场景
`gst-discoverer-1.0`	分析媒体文件的流信息	检查视频编码、分辨率、时长
`gst-play-1.0`	简易播放器	快速测试文件能否正常播放
`gst-typefind-1.0`	检测文件或流的 MIME 类型	判断裸流是什么格式

举个例子，你拿到一个 .ts 文件，不确定里面是 H.264 还是 H.265：

gst-discoverer-1.0 input.ts

输出会告诉你视频编码、音频编码、码率、时长。嗯，省得你猜。

2.5 验证开发环境：写一个最小 C 程序

光用命令行还不够。你以后写应用肯定要调 GStreamer 的 C API。咱们验证一下编译环境。

// test_gst.c
#include <gst/gst.h>

int main(int argc, char *argv[]) {
    gst_init(&argc, &argv);
    GstElement *pipeline = gst_pipeline_new("test-pipeline");
    GstElement *src = gst_element_factory_make("videotestsrc", "src");
    GstElement *sink = gst_element_factory_make("autovideosink", "sink");

    if (!pipeline || !src || !sink) {
        g_printerr("元素创建失败，请检查插件是否安装\n");
        return -1;
    }

    gst_bin_add_many(GST_BIN(pipeline), src, sink, NULL);
    gst_element_link(src, sink);

    gst_element_set_state(pipeline, GST_STATE_PLAYING);
    g_usleep(2000000); // 跑 2 秒

    gst_element_set_state(pipeline, GST_STATE_NULL);
    gst_object_unref(pipeline);
    return 0;
}

编译命令：

gcc test_gst.c -o test_gst $(pkg-config --cflags --libs gstreamer-1.0)

如果编译通过，运行后能看到测试画面，说明你的开发环境完全就绪。

避坑指南： 我曾经在 Ubuntu 20.04 上遇到 pkg-config 找不到 gstreamer-1.0.pc。原因是只装了运行时包，没装 libgstreamer1.0-dev。记住：开发头文件必须装，否则编译会报 undefined reference。

2.6 本章知识体系总览

下面这张图帮你理清环境搭建的完整链路：

2.7 常见问题速查

问题现象	可能原因	解决办法
`videotestsrc` 找不到	没装 `gstreamer1.0-plugins-base`	`sudo apt install gstreamer1.0-plugins-base`
`autovideosink` 报错	缺少视频输出后端	装 `gstreamer1.0-vaapi` 或 `gstreamer1.0-x`
编译时 undefined reference	没装 `libgstreamer1.0-dev`	安装 dev 包，用 `pkg-config` 链接
`gst-inspect-1.0` 输出为空	GST_PLUGIN_PATH 环境变量未设置	`export GST_PLUGIN_PATH=/usr/lib/x86_64-linux-gnu/gstreamer-1.0`

嗯，环境搭建就这些。工具链装好、命令行跑通、C 程序编译通过，你就可以放心进入下一阶段的管道实战了。记住：环境稳了，后面写管道才不慌。