Python+Tkinter中使用GStreamer播放视频无法捕获EOS事件问题

问题解决：无法捕获EOS消息 #

你的代码核心问题是GStreamer的消息总线未与Tkinter的事件循环整合：Tkinter运行独立的主循环，而GStreamer的消息默认在GLib主循环中处理，两者未协同工作，导致on_message函数永远不会被触发。

修复步骤 #

1. 初始化GObject线程支持，确保GLib与Tkinter的循环能协同运行；
2. 使用bus.add_watch()替代bus.connect('message', ...)，将消息监听注册到GLib主循环，让Tkinter主循环能处理GStreamer的消息。

修改后的完整代码 #

#!/usr/bin/env python3
import sys
import os

import tkinter

import gi
gi.require_version('Gst', '1.0')
from gi.repository import Gst, GObject  # noqa E402

gi.require_version('GstVideo', '1.0')
from gi.repository import GstVideo  # noqa E402,F401


def stop_video(gst):
    gst.set_state(Gst.State.NULL)
    gst.set_state(Gst.State.READY)


def set_frame_handle(bus, message, frame_id):
    structure = message.get_structure()
    if structure is not None:
        if structure.get_name() == 'prepare-window-handle':
            display_frame = message.src
            display_frame.set_property('force-aspect-ratio', True)
            display_frame.set_window_handle(frame_id)


def quit_window(player, window):
    stop_video(player)
    window.destroy()


def on_message(bus, message):
    print("on message")
    t = message.type
    if t == Gst.MessageType.EOS:
        print("eos")
        # 可在此添加视频结束后的后续操作
        stop_video(player)


Gst.init(None)
# 新增：初始化GObject线程支持
GObject.threads_init()

window = tkinter.Tk()
player = Gst.ElementFactory.make('playbin', None)
fullname = os.path.abspath(sys.argv[1])
window.protocol('WM_DELETE_WINDOW', lambda: quit_window(player, window))

window.title("Example tk-gstreamer video player")
window.geometry('640x360')

display_frame = tkinter.Frame(window, bg='')
display_frame.place(relx=0, rely=0, anchor=tkinter.NW, relwidth=1, relheight=1)
frame_id = display_frame.winfo_id()

player.set_property('uri', 'file://%s' % fullname)
player.set_state(Gst.State.PLAYING)

bus = player.get_bus()
bus.enable_sync_message_emission()
bus.connect('sync-message::element', set_frame_handle, frame_id)
# 替换为add_watch注册消息监听
bus.add_watch(0, on_message, None)

window.mainloop()

验证 #

运行修改后的代码，视频播放结束时会输出on message和eos日志，说明EOS消息已成功捕获。

Python版GStreamer入门资源推荐 #

• 官方Python入门章节：GStreamer官方文档包含专门的Python使用指南，从基础元素、管道概念讲起，逐步演示简单媒体应用的构建逻辑，适合入门理解核心机制。
• 官方Python示例代码：GStreamer官方示例仓库有大量Python实现的样例，涵盖播放、录制、视频处理、消息处理等常见场景，可直接运行并修改学习。
• 《GStreamer应用开发手册》Python适配学习：虽原手册以C语言为主，但可对照着将C代码翻译成Python，结合官方Python API文档，快速掌握GStreamer核心工作流。
• 社区实战教程：不少技术博客有针对Python开发者的GStreamer入门文章，从搭建音频播放器开始，逐步扩展到视频渲染、EOS/错误消息处理等实战场景，更贴近初学者需求。

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