Gstreamer Python RTSP服务端启动串/Caps修正问题

核心问题定位 #

• 原示例重写SensorFactory.__init__后能运行但有隐性问题，本质是自定义数据源（OpenCV处理后的帧）与GStreamer Pipeline的Caps格式不匹配
• 替换验证过的Pipeline后报can't prepare media，是因为appsrc的配置（Caps、格式、帧率参数）未与后续链路对齐
• 移除appsrc触发AttributeError，说明代码逻辑依赖appsrc作为帧输入入口，不能直接删除

修正步骤 #

1. 严格对齐appsrc的Caps与OpenCV输出格式 #

OpenCV处理后的帧默认是BGR格式，需明确指定分辨率、帧率，确保与后续链路兼容：

# 示例：640x480分辨率、30fps、BGR格式的Caps配置
caps = Gst.Caps.from_string("video/x-raw,format=BGR,width=640,height=480,framerate=30/1")
appsrc.set_property("caps", caps)

2. 修正Pipeline启动串（含格式转换与RTSP推送） #

完整链路需包含格式转换与H.264编码（RTSP推送常用格式），示例启动串：

appsrc name=src ! videoconvert ! x264enc tune=zerolatency bitrate=500 ! rtph264pay ! udpsink host=0.0.0.0 port=5000

同时初始化appsrc的关键属性：

appsrc = Gst.ElementFactory.make("appsrc", "src")
appsrc.set_property("is-live", True)
appsrc.set_property("format", Gst.Format.TIME)

3. 重写SensorFactory.__init__的正确方式 #

无需替换整个Pipeline，仅在原工厂类中适配appsrc配置与帧推送逻辑：

class SensorFactory(Gst.AppSrc):
    def __init__(self, **kwargs):
        super().__init__(**kwargs)
        self.set_property("is-live", True)
        self.set_property("format", Gst.Format.TIME)
        # 绑定Caps
        caps = Gst.Caps.from_string("video/x-raw,format=BGR,width=640,height=480,framerate=30/1")
        self.set_property("caps", caps)
        self.connect("need-data", self.on_need_data)

    def on_need_data(self, src, length):
        # 此处获取OpenCV处理后的BGR格式帧frame
        buf = Gst.Buffer.new_wrapped(frame.tobytes())
        # 设置时间戳保证帧率稳定
        buf.duration = Gst.util_uint64_scale_int(1, Gst.SECOND, 30)
        src.emit("push-buffer", buf)

4. can't prepare media错误排查要点 #

• 验证GStreamer插件完整性：用gst-inspect-1.0 x264enc、gst-inspect-1.0 rtph264pay确认插件安装
• 确保RTSP服务端监听地址/端口与udpsink配置一致
• 检查OpenCV输出帧的分辨率、格式与Caps完全匹配，避免尺寸/格式不兼容

5. 避免AttributeError的注意事项 #

• appsrc是OpenCV帧与GStreamer Pipeline的核心连接点，不能移除
• 确保所有引用appsrc的代码（回调、属性设置）都已完成初始化，避免空引用

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