Windows平台PyQt+VLC播放视频时上层透明Label无法显示下层画面问题

Windows平台下VLC默认使用硬件叠加层（Overlay）渲染视频，调用set_hwnd绑定窗口句柄后，VLC会直接将视频帧输出到显示设备的独立硬件层，完全绕过Qt的窗口绘制堆栈。叠在上方的QLabel的透明区域不会触发Qt去读取VLC渲染的视频内容，所以显示为空白/黑色块。

仅需要两处修改即可适配现有代码：

1. 实例化VLC实例时传入--disable-overlay参数，禁用硬件叠加层，强制VLC将视频渲染到Qt窗口的表面，让Qt的层级渲染逻辑生效
2. 给QLabel开启透明背景属性，确保控件背景完全透明

import sys
import vlc

from PyQt5 import QtCore, QtGui, QtWidgets
from PyQt5.QtCore import Qt
from PyQt5.QtGui import QFont


class Player(QtWidgets.QMainWindow):

    def __init__(self):
        super().__init__()
        self.setWindowTitle("Media Player")

        # 关键修改1：创建vlc实例时传入禁用overlay参数
        self.instance = vlc.Instance("--disable-overlay")

        self.media = None

        # 创建空的vlc媒体播放器
        self.mediaplayer = self.instance.media_player_new()

        self.widget = QtWidgets.QWidget(self)
        self.setCentralWidget(self.widget)

        self.lbl = QtWidgets.QLabel()
        font = QFont('Helvetica', 16, QFont.Bold)
        self.lbl.setFont(font)
        self.lbl.setText("这是我的\n透明\n标签")
        self.lbl.setAlignment(Qt.AlignCenter)
        self.lbl.setFixedSize(200,200)
        # 关键修改2：开启label透明背景，设置文字颜色避免和视频背景撞色
        self.lbl.setAttribute(Qt.WA_TranslucentBackground)
        self.lbl.setStyleSheet("color: #ffffff; background: transparent;")

        self.videoframe = QtWidgets.QFrame(frameShape=QtWidgets.QFrame.Box, frameShadow=QtWidgets.QFrame.Raised)
        self.videoframe.setFixedSize(600,600)

        self.mediaplayer.set_hwnd(int(self.videoframe.winId()))

        fileName = "C:\\Users\\...\\test.mp4" # 替换为你的本地视频路径
        self.media = self.instance.media_new(fileName)

        # 将媒体加载到播放器中
        self.mediaplayer.set_media(self.media)
        # 解析文件元数据
        self.media.parse()

        self.vboxlayout = QtWidgets.QGridLayout()
        self.vboxlayout.addWidget(self.videoframe,0,0)
        self.vboxlayout.addWidget(self.lbl,0,0)
        self.widget.setLayout(self.vboxlayout)

        self.mediaplayer.play() 

if __name__ == "__main__":
    app = QtWidgets.QApplication(sys.argv)
    player = Player()
    player.show()
    sys.exit(app.exec_())

• 禁用硬件叠加层会略微提升CPU占用，不过常规1080P及以下分辨率的视频在现代设备上完全没有性能问题
• 如果需要更高的渲染性能，可以改用QGraphicsView架构，将VLC的视频帧捕获后作为QGraphicsItem渲染，再叠加文字控件，不过改造成本远高于上述方案

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