如何在GStreamer中统一设置v4l2src的图像分辨率？

疑问解答 #

没错，GStreamer无法直接跨所有媒体格式统一设置分辨率。不同媒体格式的Caps定义逻辑不同——比如压缩格式（image/jpeg、video/x-h264）的分辨率是编码参数，而raw格式（video/x-raw）的分辨率是帧的实际尺寸，必须针对摄像头输出的具体类型匹配对应Caps。但可以通过通用处理逻辑或动态适配实现自动化，无需手动判断格式。

方案一：通用缩放方案（推荐，无需代码） #

不需要关心摄像头输出格式，直接在解码后通过videoscale强制缩放到目标分辨率，管道如下：

v4l2src ! decodebin ! queue ! videoconvert ! videoscale ! video/x-raw,width=320,height=240 ! xvimagesink

原理 #

不管摄像头输出image/jpeg、video/x-raw还是video/x-h264，decodebin都会自动匹配对应解码器，输出标准video/x-raw格式；videoscale负责将帧统一缩放到320x240，完全兼容所有摄像头格式。

方案二：源头限制分辨率（适合低带宽场景） #

如果需要在摄像头输出端就限制分辨率（减少传输带宽），可以修正你用prepare-format信号的实现，直接调整v4l2src的格式选择：

修正后的代码 #

void onV4l2Prepare(GstElement *src, gint /*arg0*/, GstCaps *arg1, gpointer user_data)
{
    // 获取当前候选格式的媒体类型
    GstStructure *structure = gst_caps_get_structure(arg1, 0);
    const gchar *media_type = gst_structure_get_name(structure);

    // 复制候选Caps并修改分辨率，保留原格式的其他参数（如帧率、像素格式）
    GstCaps *target_caps = gst_caps_copy(arg1);
    gst_structure_set(gst_caps_get_structure(target_caps, 0),
                      "width", G_TYPE_INT, 320,
                      "height", G_TYPE_INT, 240,
                      NULL);

    // 强制v4l2src选择目标格式
    g_object_set(G_OBJECT(src), "caps", target_caps, NULL);
    gst_caps_unref(target_caps);

    g_print("Set target resolution for %s: 320x240\n", media_type);
}

关键修正点 #

1. 正确使用GstCaps对象：之前直接传字符串给capsfilter是错误的，必须创建标准GstCaps对象并设置属性。
2. 直接修改v4l2src的Caps：prepare-format信号的作用就是调整v4l2src的格式选择，直接设置其caps属性比用capsfilter更高效。
3. 保留原格式参数：复制候选Caps并仅修改分辨率，兼容原格式的帧率、像素格式等参数，避免兼容性问题。

信号连接方式 #

创建v4l2src后，绑定prepare-format信号：

GstElement *v4l2src = gst_element_factory_make("v4l2src", "v4l2src");
g_signal_connect(v4l2src, "prepare-format", G_CALLBACK(onV4l2Prepare), pipeline_);

验证生效方式 #

之前打印current caps的时机不对（管道协商未完成），可以监听src pad的notify::caps信号，在协商完成后获取实际生效的Caps：

static void onPadCapsChanged(GstPad *pad, GParamSpec *pspec, gpointer user_data)
{
    GstCaps *caps = gst_pad_get_current_caps(pad);
    gchar *caps_str = gst_caps_to_string(caps);
    g_print("Actual output caps: %s\n", caps_str);
    g_free(caps_str);
    gst_caps_unref(caps);
}

// 在创建v4l2src后添加监听
GstPad *src_pad = gst_element_get_static_pad(v4l2src, "src");
g_signal_connect(src_pad, "notify::caps", G_CALLBACK(onPadCapsChanged), NULL);
gst_object_unref(src_pad);

内容的提问来源于stack exchange，提问作者CmykCmyk