Homebrew安装Gstreamer后Python视频无法显示问题求助

问题概述 #

学习GStreamer基础Python教程时，前两个示例出现无视频输出异常：

• 第2课使用videotestsrc+autovideosink的代码运行时，Dock栏Python图标跳动，但无视频窗口；启用GST_DEBUG=5能看到日志和时间流转，仍无视频输出。
• 第1课基于playbin的代码运行时，可正常播放音频，但无视频窗口，Dock栏也无Python图标。
• 将音频元素替换为audiotestsrc+autoaudiosink后，可正常播放蜂鸣声。
• GStreamer命令行工具运行等效管道可正常显示视频，例如：

  gst-launch-1.0 playbin uri=https://gstreamer.freedesktop.org/data/media/sintel_trailer-480p.webm
  gst-launch-1.0 videotestsrc pattern=0 ! autovideosink
  

第2课参考代码 #

#!/usr/bin/env python3
import sys
import gi
import logging

gi.require_version("GLib", "2.0")
gi.require_version("GObject", "2.0")
gi.require_version("Gst", "1.0")

from gi.repository import Gst, GLib, GObject


logging.basicConfig(level=logging.DEBUG, format="[%(name)s] [%(levelname)8s] - %(message)s")
logger = logging.getLogger(__name__)

# Initialize GStreamer
Gst.init(sys.argv[1:])

# Create the elements
source = Gst.ElementFactory.make("videotestsrc", "source")
sink = Gst.ElementFactory.make("autovideosink", "sink")

# Create the empty pipeline
pipeline = Gst.Pipeline.new("test-pipeline")

if not pipeline or not source or not sink:
    logger.error("Not all elements could be created.")
    sys.exit(1)


# Build the pipeline
pipeline.add(source, sink)
if not source.link(sink):
    logger.error("Elements could not be linked.")
    sys.exit(1)

# Modify the source's properties
source.props.pattern = 0
# Can alternatively be done using `source.set_property("pattern",0)`
# or using `Gst.util_set_object_arg(source, "pattern", 0)`

# Start playing
ret = pipeline.set_state(Gst.State.PLAYING)
if ret == Gst.StateChangeReturn.FAILURE:
    logger.error("Unable to set the pipeline to the playing state.")
    sys.exit(1)

# Wait for EOS or error
bus = pipeline.get_bus()
msg = bus.timed_pop_filtered(Gst.CLOCK_TIME_NONE, Gst.MessageType.ERROR | Gst.MessageType.EOS)

# Parse message
if msg:
    if msg.type == Gst.MessageType.ERROR:
        err, debug_info = msg.parse_error()
        logger.error(f"Error received from element {msg.src.get_name()}: {err.message}")
        logger.error(f"Debugging information: {debug_info if debug_info else 'none'}")
    elif msg.type == Gst.MessageType.EOS:
        logger.info("End-Of-Stream reached.")
    else:
        # This should not happen as we only asked for ERRORs and EOS
        logger.error("Unexpected message received.")

pipeline.set_state(Gst.State.NULL)

环境信息 #

• GStreamer：通过brew install gstreamer安装，版本1.22.2（stable bottled）
• Python：3.11.3
• 系统：Mac OS Ventura 13.2.1 (22D68)

解决方法 #

1. 初始化GLib主循环处理UI事件 #

Mac OS上GStreamer视频输出依赖GLib主循环处理UI事件，原代码仅用bus.timed_pop_filtered无法满足需求。修改代码，替换总线等待逻辑为GLib主循环：

# Start playing
ret = pipeline.set_state(Gst.State.PLAYING)
if ret == Gst.StateChangeReturn.FAILURE:
    logger.error("Unable to set the pipeline to the playing state.")
    sys.exit(1)

# 创建GLib主循环
loop = GLib.MainLoop()

# 总线消息回调函数
def bus_call(bus, msg, loop):
    if msg.type == Gst.MessageType.ERROR:
        err, debug_info = msg.parse_error()
        logger.error(f"Error received from element {msg.src.get_name()}: {err.message}")
        logger.error(f"Debugging information: {debug_info if debug_info else 'none'}")
        loop.quit()
    elif msg.type == Gst.MessageType.EOS:
        logger.info("End-Of-Stream reached.")
        loop.quit()
    return True

# 绑定总线信号监听
bus = pipeline.get_bus()
bus.add_signal_watch()
bus.connect("message", bus_call, loop)

# 启动主循环
try:
    loop.run()
except KeyboardInterrupt:
    pass

# 清理资源
pipeline.set_state(Gst.State.NULL)

2. 显式指定Mac原生视频sink #

autovideosink在Python环境中可能无法自动选择正确的后端，尝试替换为Mac原生的osxvideosink：

sink = Gst.ElementFactory.make("osxvideosink", "sink")

3. 补全GStreamer依赖组件 #

确保安装完整的Python绑定和视频插件：

brew install gst-python gst-plugins-good gst-plugins-bad gst-plugins-ugly

4. 修复GI类型库路径 #

Mac上brew安装的GStreamer可能需要手动指定GI路径，在代码开头添加：

import os
# 路径可通过`brew --prefix gstreamer`获取前缀后拼接
os.environ['GI_TYPELIB_PATH'] = '/usr/local/lib/girepository-1.0'

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