3. GStreamer 插件体系：分类、注册与加载机制

好，咱们进入第三章。这一章我打算聊聊 GStreamer 的插件体系。说白了，GStreamer 本身就是一个空壳子，真正干活的是那些插件。你想想看，没有插件，它连个文件都打不开。

我在刚开始接触 GStreamer 的时候，总觉得这玩意儿很神秘。后来自己动手写了一个 source 插件，才明白它的设计有多巧妙。今天咱们就把插件体系拆开来看。

GStreamer 的插件按功能分，主要有这么几类。我习惯把它们比作水管里的不同接头：

分类	英文名	作用	典型例子
源插件	Source	产生数据，没有输入 pad	filesrc, videotestsrc, audiotestsrc
接收插件	Sink	消费数据，没有输出 pad	filesink, autovideosink, alsasink
过滤器	Filter	数据变换，有输入和输出 pad	videoconvert, capsfilter, queue
编码器/解码器	Encoder/Decoder	压缩或解压缩数据	x264enc, x265enc, avdec_h264
混合器/分离器	Muxer/Demuxer	合并或拆分多个流	matroskamux, qtdemux

嗯，这里要注意。source 和 sink 是管道的两端。filter 在中间做处理。编码器其实也是一种特殊的 filter，只不过它干的是压缩的活。

核心概念： 一个插件可以包含多个 element（元素）。比如 x265enc 这个插件，里面就只有一个 x265enc 元素。但有些插件包，比如 gst-plugins-good，里面有好几十个元素。

GStreamer 怎么知道系统里有哪些插件？这个过程我当年调试了好久才搞明白。它分三步走：

扫描路径：GStreamer 启动时，会去默认的插件目录下找 .so 文件。默认路径一般是 /usr/lib/x86_64-linux-gnu/gstreamer-1.0/。
加载插件：每个 .so 文件里都有一个 plugin_init 函数。GStreamer 调用这个函数，把插件里所有的 element 注册到全局的插件注册表中。
缓存注册表：第一次扫描后，GStreamer 会把结果缓存到 ~/.cache/gstreamer-1.0/registry.xml 里。下次启动就不用再扫一遍了，快很多。

我曾经遇到过一个问题：自己写了一个插件，怎么都加载不上。后来发现是注册表缓存没更新。删掉那个 registry.xml 文件，重新运行就好了。这个坑我踩过，你们别踩。

小技巧： 可以用 gst-inspect-1.0 命令查看插件是否注册成功。比如 gst-inspect-1.0 x265enc，如果能看到详细信息，说明插件加载成功了。

咱们这门课主要讲 H.265 编码，所以编码相关的插件是重点。我列几个常用的：

我个人习惯，在开发阶段用 x265enc 做软件编码，调试方便。到了产品部署，如果硬件支持，就换成 nvh265enc 或者 qsvh265enc，性能能提升好几倍。

注意： 硬件编码器虽然快，但参数控制不如软件编码器灵活。比如 x265enc 可以调很多编码参数，但 nvh265enc 能调的参数就少很多。选型的时候要权衡。

下面这张图是我画的 GStreamer 插件体系结构。你看一眼，应该能对整个体系有个直观的认识。

你可以在终端里用 gst-inspect-1.0 查看所有已注册的插件。我个人习惯这样用：

# 列出所有插件
gst-inspect-1.0 | grep -i h265

# 查看 x265enc 的详细信息
gst-inspect-1.0 x265enc

# 查看某个插件属于哪个包
gst-inspect-1.0 --plugin x265enc

输出结果里会显示插件的 pad 信息、支持的 caps（能力集）、参数等。这些信息在调试的时候特别有用。

调试技巧： 如果你发现某个插件加载失败，可以设置环境变量 GST_DEBUG=*:3 来查看详细的加载日志。我经常用这招来定位问题。

嗯，这里我总结几个我踩过的坑：

插件找不到：检查 GST_PLUGIN_PATH 环境变量是否设置正确。我习惯把自定义插件放在 ~/gst-plugins 目录下，然后 export GST_PLUGIN_PATH=~/gst-plugins。
版本不匹配：GStreamer 1.0 的插件不能用在 0.10 版本上。编译插件时一定要链接正确的库版本。
依赖缺失：比如 x265enc 依赖 libx265 库。如果系统没装，插件就加载不了。用 ldd 命令可以检查依赖是否完整。

好了，这一章就到这里。插件体系是 GStreamer 的基石，搞懂了它，后面写 pipeline 就顺手多了。