4、第一个Pipeline：用gst-launch-1.0 构建一个简单的音视频播放管道
好，咱们终于到了动手的环节。
前面几章讲了那么多理论，什么元素、垫片、箱子……说实话，光看概念容易犯困。我自己当年学 GStreamer 的时候，也是看了半天文档，不如直接敲一条命令来得痛快。
这一章，我们就用 gst-launch-1.0 这个命令行工具，搭出人生中第一个能跑起来的 Pipeline。你不需要写一行 C 代码，甚至不需要懂编程——只要会打字就行。
4.1 什么是 gst-launch-1.0？
简单说，gst-launch-1.0 是 GStreamer 自带的一个命令行工具。它的作用就是让你用字符串描述一个 Pipeline，然后立刻执行它。
你可以把它理解成「管道速写板」。想测试某个摄像头能不能用？想看看某个视频文件能不能播？一条命令搞定，不用编译、不用写代码。
我个人习惯在调试阶段大量使用它。为什么呢？因为快。你想想看，改一行字符串比改 C 代码再编译快太多了。
sudo apt install gstreamer1.0-tools gstreamer1.0-plugins-base gstreamer1.0-plugins-good 就行。
4.2 第一个命令：播放一个测试视频
我们先从最简单的开始——播放一个内置的测试图案。GStreamer 提供了一个叫 videotestsrc 的元素，它能生成各种测试视频信号，比如彩条、雪花、棋盘格等等。
gst-launch-1.0 videotestsrc ! autovideosink敲下回车，你应该能看到一个窗口弹出来，里面显示着动态的彩条图案。
这条命令干了什么？
videotestsrc：源元素，生成视频数据。!：管道连接符，表示数据从左流到右。autovideosink：接收元素，自动选择一个合适的窗口来显示视频。
说白了，就是「生成视频 → 显示出来」。就这么简单。
fakesink 代替 autovideosink，它只接收数据但不显示。
4.3 加上声音：让管道更完整
光有画面没声音，总觉得少了点什么。GStreamer 也有对应的音频测试源——audiotestsrc。它能生成正弦波、白噪声等音频信号。
但问题来了：视频和音频是两个不同的数据流，怎么把它们合并到一个 Pipeline 里？
答案是：用 videomixer 或者更简单的 playbin。不过这一章我们先用最直观的方式——并行管道。
gst-launch-1.0 videotestsrc ! autovideosink audiotestsrc ! autoaudiosink注意看，这条命令里有两个 ! 连接，但中间没有用 ! 把视频和音频串起来。实际上，gst-launch-1.0 允许你在一行里写多个独立的管道，用空格隔开就行。
运行之后，你应该能看到彩条，同时听到「嘟——」的声音（默认是 440Hz 的正弦波）。
audiotestsrc 的采样率和声卡不匹配。解决办法是加上 audioresample 元素做重采样。比如：audiotestsrc ! audioresample ! autoaudiosink。
4.4 播放一个真实的视频文件
测试图案看多了也无聊。咱们来点真家伙——播放一个本地视频文件。
GStreamer 里负责读取文件的元素叫 filesrc，但它只负责读字节流，不知道文件是什么格式。所以我们需要一个能解析格式的元素——qtdemux（用于 MP4/MOV 格式）或者 matroskademux（用于 MKV 格式）。
不过，更省事的办法是用 playbin。它是一个高级元素，内部自动帮你搞定文件解析、音视频解码、同步播放等所有事情。
gst-launch-1.0 playbin uri=file:///home/user/video.mp4把路径换成你自己的视频文件路径，运行即可。
这里要注意：uri 参数必须是完整的 URI 格式，本地文件要用 file:// 开头。
4.5 手动搭建一个完整的播放管道
用 playbin 虽然方便，但不够灵活。如果你想控制解码器、调整缓冲大小、或者插入自定义滤镜，就得手动搭建管道。
下面是一个手动搭建的 MP4 播放管道示例：
gst-launch-1.0 filesrc location=video.mp4 ! qtdemux name=demux \
demux.video_0 ! queue ! decodebin ! videoconvert ! autovideosink \
demux.audio_0 ! queue ! decodebin ! audioconvert ! autoaudiosink这条命令看起来有点长，我们拆开看：
filesrc location=video.mp4：读取文件。qtdemux name=demux：解析 MP4 容器，并给它起个名字叫demux。demux.video_0和demux.audio_0：从 demux 里分别取出视频流和音频流。queue：缓冲队列，防止数据抖动。我个人习惯在每个分支前都加一个 queue，能避免很多同步问题。decodebin：自动选择合适的解码器。videoconvert/audioconvert：格式转换，确保输出兼容显示设备。autovideosink/autoaudiosink：最终输出。
4.6 常用调试技巧
刚开始用 gst-launch-1.0 时，你可能会遇到各种报错。别慌，这里有几个我常用的调试方法：
| 问题现象 | 可能原因 | 解决方法 |
|---|---|---|
| 「No such element」 | 缺少插件 | 安装对应的 gstreamer 插件包，比如 gstreamer1.0-plugins-bad |
| 「Negotiation failed」 | 格式不匹配 | 在中间插入 videoconvert 或 audioconvert |
| 「Internal data flow error」 | 管道连接错误 | 检查 pad 名称是否正确，比如 video_0 还是 video_00 |
| 画面卡顿或撕裂 | 缺少队列或队列太小 | 在关键节点加上 queue 元素 |
另外，你可以在命令后面加上 -v 参数（verbose 模式），它会打印出每个元素的详细信息，包括 caps（能力协商）的结果。这对调试非常有帮助。
gst-launch-1.0 -v videotestsrc ! autovideosink4.7 本章小结
这一章我们做了三件事：
- 用
videotestsrc和audiotestsrc生成了测试音视频。 - 用
playbin快速播放了一个真实视频文件。 - 手动搭建了一个完整的 MP4 播放管道，理解了数据分流和合并的原理。
嗯，到这里你应该已经对 gst-launch-1.0 有了直观的感受。它就像 GStreamer 世界的「hello world」，但别小看它——很多复杂的流媒体服务，最初都是从这样一条简单的命令开始调试的。
下一章，我们会深入 Pipeline 的内部结构，看看数据到底是怎么在元素之间流动的。到时候你会发现，今天搭的这些管道，其实藏着很多有意思的细节。