X11下Python如何将MPV渲染至GTK4窗口（附代码与报错）

报错根因 #

触发该类型错误是因为代码实现违反GTK4的接口设计规则：

1. GdkX11.X11Surface.get_xid()仅接受GdkX11.X11Surface类型入参，不能直接传入Gtk.Frame这类GTK控件实例
2. GTK4移除了普通子控件的独立X窗口，仅实现Gtk.Native接口的组件（顶层窗口、原生可绘制控件）会关联平台层surface，且必须等控件触发realize信号、完成资源初始化挂载后，才能获取到有效surface对象，控件刚创建时取值会出现类型不匹配或空值问题。

正确实现要点 #

• 选用Gtk.DrawingArea作为mpv的渲染承载控件，不要使用普通布局/容器控件
• 给承载控件绑定realize信号回调，在控件完成资源初始化后再执行XID获取、mpv初始化逻辑
• 取XID时先通过控件拿到所属的native对象，再获取其对应的surface，校验类型为X11Surface后再调用get_xid方法
• 保留libmpv要求的numeric locale配置，必须在创建mpv实例前执行

可运行修正代码 #

#!/usr/bin/env python3
import gi
import mpv

gi.require_version('Gtk', '4.0')
gi.require_version('Gdk', '4.0')
gi.require_version('GdkX11', '4.0')
from gi.repository import Gtk, Gdk, GdkX11


class MainClass(Gtk.ApplicationWindow):
    def __init__(self, app):
        super().__init__(application=app)
        self.set_default_size(600, 400)
        self.connect("close-request", self.on_close)

        # 用DrawingArea作为mpv渲染承载控件
        self.render_area = Gtk.DrawingArea()
        self.set_child(self.render_area)
        # 等控件完成realize后再初始化mpv拿XID
        self.render_area.connect("realize", self.on_render_area_ready)
        self.present()

    def on_render_area_ready(self, widget):
        # 先拿控件关联的native surface
        surface = widget.get_native().get_surface()
        # 校验当前运行在X11环境下
        if not isinstance(surface, GdkX11.X11Surface):
            raise RuntimeError("仅支持X11环境下的mpv窗口绑定")
        # 获取XID初始化mpv
        xid = GdkX11.X11Surface.get_xid(surface)
        self.mpv = mpv.MPV(wid=str(xid))
        self.mpv.play("test.webm")

    def on_close(self, _):
        # 窗口关闭时先释放mpv资源
        if hasattr(self, "mpv"):
            self.mpv.terminate()


def on_activate(app):
    MainClass(app)


if __name__ == '__main__':
    # 修复libmpv依赖的numeric locale设置，必须在创建mpv实例前执行
    import locale
    locale.setlocale(locale.LC_NUMERIC, 'C')

    app = Gtk.Application()
    app.connect('activate', on_activate)
    app.run(None)

补充：如果需要直接渲染到整个窗口而非子控件，直接给窗口本身绑定realize信号，用窗口的surface拿XID即可，逻辑完全一致。

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