2、开发环境搭建：在Ubuntu上安装GStreamer、常用工具介绍
说实话，很多初学者在滤镜调优上栽跟头，不是因为算法多难，而是环境没搭对。我见过不少同事花了一整天调试一个滤镜，最后发现是安装的插件包不全。所以这一章，咱们先把地基打牢。
2.1 在Ubuntu上安装GStreamer
Ubuntu 对 GStreamer 的支持相当成熟。我个人习惯用 apt 安装，简单直接。但要注意——别只装一个核心包就以为完事了。
2.1.1 核心运行时与开发库
先装运行时环境。打开终端，执行：
sudo apt update
sudo apt install libgstreamer1.0-0 gstreamer1.0-tools gstreamer1.0-plugins-base
这三行搞定最基础的东西。libgstreamer1.0-0 是核心库，gstreamer1.0-tools 包含我们马上要讲的 gst-launch 和 gst-inspect，gstreamer1.0-plugins-base 是基础插件集。
如果你要做开发，比如自己写滤镜或者调优 pipeline，还需要开发头文件：
sudo apt install libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev
gst-inspect-1.0 --version 确认版本。如果输出版本号，说明核心装好了。如果报错，八成是 libgstreamer1.0-0 没装全。
2.1.2 插件包的选择
GStreamer 的插件分三个等级：好（good）、坏（bad）、丑（ugly）。名字听着吓人，其实只是许可证和稳定性的区别。
| 包名 | 包含内容 | 许可证 | 我建议 |
|---|---|---|---|
gstreamer1.0-plugins-good |
高质量、广泛使用的滤镜（如 videoconvert、audioconvert） | LGPL | 必装 |
gstreamer1.0-plugins-bad |
较新或不够稳定的滤镜（如 webrtc、dash） | LGPL / 部分专有 | 建议装 |
gstreamer1.0-plugins-ugly |
可能涉及专利的编解码器（如 MP3、H.264） | GPL / 专有 | 按需装 |
安装命令很简单：
sudo apt install gstreamer1.0-plugins-good gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly
嗯，这里要注意。如果你在某个国家或公司有严格的专利合规要求，ugly 包可能需要跳过。我在一家做视频会议的公司干过，法务明确要求不能装 ugly，我们只能用 good 和 bad 里的开源编解码器。
2.1.3 额外工具与调试支持
做滤镜调优，调试工具是刚需。我建议再装这几个：
sudo apt install gstreamer1.0-tools gstreamer1.0-alsa gstreamer1.0-pulseaudio
gstreamer1.0-tools 我们已经有了，但这里再显式装一次确保版本一致。alsa 和 pulseaudio 是音频后端，调试音频滤镜时用得上。
ubuntu-gst PPA 或者从源码编译。不过对于本课程，Ubuntu 默认源完全够用。
2.2 常用工具介绍
装好环境后，有两个工具你几乎每天都会用：gst-launch-1.0 和 gst-inspect-1.0。说白了，一个是跑 pipeline 的，一个是查插件信息的。
2.2.1 gst-launch-1.0：快速构建与测试
gst-launch-1.0 是一个命令行工具，让你不用写代码就能构建和运行 GStreamer pipeline。它的语法是：
gst-launch-1.0 [选项] PIPELINE-DESCRIPTION
举个例子，播放一个测试视频：
gst-launch-1.0 videotestsrc ! autovideosink
这条命令的意思是：videotestsrc 生成测试画面，通过管道传给 autovideosink 显示出来。你会在屏幕上看到一个彩条图案。
再复杂一点，加一个滤镜：
gst-launch-1.0 videotestsrc ! videoconvert ! videoscale ! video/x-raw,width=640,height=480 ! autovideosink
这里 videoconvert 做格式转换，videoscale 做缩放，video/x-raw,width=640,height=480 是 caps（能力协商），告诉下游我要 640x480 的原始视频。
gst-launch-1.0 的管道描述符 ! 表示数据流方向。你可以把它想象成水管，数据从左边流到右边。每个元件就是一个处理站。
常用选项：
-v：打印详细日志，调试时必开--gst-debug-level=3：设置调试级别，数字越大越详细-e：优雅退出，按 Ctrl+C 时发送 EOS 事件
我个人习惯在调试滤镜时，永远加上 -v --gst-debug-level=3。这样一旦 pipeline 报错，你能看到是哪个元件在哪个环节出了问题。
2.2.2 gst-inspect-1.0：插件信息查询
gst-inspect-1.0 是你的插件百科全书。它能告诉你系统里装了哪些插件、每个插件有什么参数、支持什么 caps。
查看所有已安装的插件：
gst-inspect-1.0
输出会很长，你可以用 grep 过滤。比如我只想看视频相关的：
gst-inspect-1.0 | grep video
查看某个插件的详细信息：
gst-inspect-1.0 videotestsrc
输出会包含：
- 插件名称：如
videotestsrc - 分类：如 Source/Video
- 作者与版本
- Pad 信息：输入/输出 pad 的名称和 caps
- 属性（Properties）：可调节的参数，比如
pattern可以切换测试图案
举个例子，查看 videotestsrc 的 pattern 属性：
gst-inspect-1.0 videotestsrc | grep -A 10 "pattern"
你会看到它支持 smpte、ball、snow 等多种图案。你可以这样用：
gst-launch-1.0 videotestsrc pattern=ball ! autovideosink
gst-inspect-1.0 | grep -i "关键字" 模糊搜索。比如搜 "scale" 就能找到 videoscale、scaletempo 等。
2.3 知识体系总览
下面这张图帮你理清本章的核心逻辑。从安装到工具，再到实际使用，每一步都有明确的依赖关系。
2.4 验证环境是否就绪
装完所有东西后，我建议跑一个完整的验证流程。别嫌麻烦，这一步能帮你省掉后面很多排查时间。
- 检查版本：
gst-launch-1.0 --version和gst-inspect-1.0 --version - 检查插件数量：
gst-inspect-1.0 | wc -l，正常应该在 200 以上 - 跑一个简单 pipeline：
gst-launch-1.0 videotestsrc ! autovideosink，看画面是否正常显示 - 测试音频：
gst-launch-1.0 audiotestsrc ! autoaudiosink，听是否有测试音 - 测试滤镜链：
gst-launch-1.0 videotestsrc ! videoconvert ! videoscale ! video/x-raw,width=320,height=240 ! autovideosink
如果以上五步都通过，恭喜你，环境搭建完成。你可以开始后面的滤镜实战了。
videoconvert 没装。所以如果你遇到类似问题，先检查插件包是否装全，别急着怀疑代码。