当前位置：首页 > news >正文

【GStreamer实战】从USB相机到文件：一站式掌握图片抓取与视频录制

news 2026/4/19 19:33:55

1. 环境准备与设备检测

第一次接触GStreamer处理USB相机时，我最头疼的就是环境配置问题。记得有次在Jetson TX2上折腾了整整两天，才发现是缺少了v4l-utils工具包。为了避免大家重蹈覆辙，这里分享几个关键检查点。

首先用lsb_release -a确认系统版本。我在Ubuntu 18.04和20.04上都测试过，建议使用官方支持的LTS版本。接着安装核心工具包：

sudo apt-get install gstreamer1.0-tools gstreamer1.0-plugins-good \ gstreamer1.0-plugins-bad v4l-utils

检测USB相机是否被系统识别：

ls /dev/video*

如果看到类似/dev/video0的设备节点，说明硬件连接正常。我遇到过USB3.0接口供电不足导致设备时断时续的情况，换成带外接电源的Hub就解决了。

用v4l2-ctl查看相机能力：

v4l2-ctl --device=/dev/video0 --list-formats-ext

这个命令会列出相机支持的分辨率和格式。比如我的罗技C920输出是这样的：

Pixel Format: 'MJPG' (compressed) Size: 1920x1080 (30 fps) Size: 1280x720 (30 fps) Pixel Format: 'YUYV' Size: 640x480 (30 fps)

注意MJPG格式通常能支持更高分辨率，而YUYV格式在相同分辨率下帧率可能更低。实际项目中，我建议先用MJPG格式获取高清画面，需要原始数据时再切到YUYV。

2. 静态图片抓取实战

2.1 捕获YUV格式图片

先看最简单的单帧抓取命令：

gst-launch-1.0 v4l2src device=/dev/video0 num-buffers=1 \ ! 'video/x-raw,format=YUY2,width=640,height=480,framerate=30/1' \ ! jpegenc ! filesink location=test.jpg

这个管道的工作流程是：

v4l2src从/dev/video0获取1帧数据
指定格式为640x480的YUYV原始数据
jpegenc编码器转换为JPEG格式
保存到test.jpg文件

我经常遇到的问题是格式不匹配。比如相机实际输出是MJPG，但管道里指定了YUYV，这时会报错：

ERROR: from element /GstPipeline:pipeline0/GstV4l2Src:v4l2src0: Internal data stream error.

解决方法是在v4l2src后立即用capfilter指定正确格式：

! 'image/jpeg,width=1280,height=720' ! jpegdec \ ! 'video/x-raw,format=YUY2' ! jpegenc

2.2 批量抓图技巧

做数据集采集时需要连续抓图，可以用multifilesink：

gst-launch-1.0 v4l2src device=/dev/video0 \ ! 'image/jpeg,width=1280,height=720,framerate=30/1' \ ! jpegdec ! videorate ! 'video/x-raw,framerate=1/1' \ ! jpegenc ! multifilesink location="frame%03d.jpg"

这里videorate组件将帧率降到1fps，每秒钟保存1张图片。我在做物体识别训练集时，这个技巧帮了大忙。

3. 视频录制方案对比

3.1 AVI格式录制

AVI是经典的容器格式，优点是兼容性好：

gst-launch-1.0 v4l2src device=/dev/video0 \ ! 'image/jpeg,width=1280,height=720,framerate=30/1' \ ! queue ! avimux ! filesink location=output.avi

但实际测试发现，直接保存MJPG流的AVI文件在Windows播放器可能有兼容问题。更稳妥的做法是统一解码再编码：

! jpegdec ! videoconvert ! jpegenc ! avimux

3.2 MP4(H.264)高清录制

H.264编码能大幅减小文件体积。这是我最常用的方案：

gst-launch-1.0 v4l2src device=/dev/video0 \ ! 'video/x-raw,format=YUY2,width=1280,height=720,framerate=30/1' \ ! videoconvert ! x264enc bitrate=2000 tune=zerolatency \ ! mp4mux ! filesink location=output.mp4

关键参数说明：

bitrate控制码率（单位kbps）
zerolatency减少编码延迟
必须包含videoconvert确保格式兼容

在Jetson平台上，可以启用硬件加速：

! omxh264enc ! 'video/x-h264,profile=high'

4. 高级应用技巧

4.1 预览+录制同步方案

使用tee组件实现一源多路：

gst-launch-1.0 v4l2src device=/dev/video0 \ ! 'image/jpeg,width=1280,height=720,framerate=30/1' \ ! tee name=t t. ! queue ! jpegdec ! autovideosink \ t. ! queue ! jpegdec ! x264enc ! mp4mux \ ! filesink location=record.mp4

注意点：

每条分支都要有独立的queue
预览分支用autovideosink自动选择显示方式
录制分支建议设置sync=false避免丢帧

4.2 音视频同步录制

如果相机带麦克风，可以这样录制：

gst-launch-1.0 v4l2src device=/dev/video0 \ ! 'image/jpeg,width=640,height=480,framerate=30/1' \ ! tee name=video \ pulsesrc ! audioconvert ! audioresample ! queue ! voaacenc \ ! mux. \ video. ! queue ! jpegdec ! x264enc ! mux. \ mp4mux name=mux ! filesink location=av.mp4

4.3 网络流媒体推流

将视频流推送到RTMP服务器：

gst-launch-1.0 v4l2src device=/dev/video0 \ ! 'video/x-raw,format=YUY2,width=640,height=480,framerate=30/1' \ ! videoconvert ! x264enc bitrate=1000 tune=zerolatency \ ! flvmux ! rtmpsink location="rtmp://example.com/live/stream"

在Jetson平台上开发时，记得监控GPU温度：