如何在PyQt5中用QWinThumbnailToolBar恢复VLC播放前后的任务栏缩略图？

我明白你遇到的困扰——VLC播放时任务栏缩略图只显示视频、不包含窗口按钮，停止播放后还变成空白。这其实是因为VLC播放时会直接接管视频帧的HWND，导致Qt默认的窗口缩略图捕获机制失效；停止播放后，VLC释放了硬件加速的渲染上下文，但Qt没及时更新缩略图缓存。

这里有个可行的解决方案，核心是手动控制任务栏缩略图的内容，结合QtWinExtras的工具类来实现：

步骤1：完善导入并添加必要工具类 #

首先确保导入QtWin，它能帮我们手动设置任务栏缩略图：

import sys
from PyQt5.QtWidgets import *
from PyQt5.QtWinExtras import QtWin, QWinThumbnailToolBar, QWinThumbnailToolButton
from PyQt5.QtCore import QTimer
from PyQt5.QtGui import QStyle
import vlc

步骤2：重构播放器类，添加缩略图更新逻辑 #

修改你的Player类，加入定时更新缩略图的逻辑，同时优化缩略图工具栏的初始化：

class Player(QMainWindow):
    def __init__(self, master=None):
        QMainWindow.__init__(self, master)
        self.setWindowTitle("Media Player")
        self.mainframe = QFrame(self)
        self.setCentralWidget(self.mainframe)
        self.videoframe = QFrame(self.mainframe)
        self.videoframe.setGeometry(0,50,600,400)

        # 初始化VLC播放器
        self.instance = vlc.Instance()
        self.player = self.instance.media_player_new()
        self.player.set_hwnd(int(self.videoframe.winId()))
        self.media = self.instance.media_new('C:/Users/mishra/Downloads/Video/kyakar.mp4')
        self.player.set_media(self.media)

        # 创建控制按钮
        button = QPushButton('Play', self)
        button.setStyleSheet('background:red')
        button.setGeometry(100,0,40,30)
        button.clicked.connect(self.start_playback)

        button1 = QPushButton('Close', self)
        button1.setStyleSheet('background:green')
        button1.setGeometry(200,0,40,30)
        button1.clicked.connect(self.onclose)

        # 初始化任务栏缩略图工具栏（仅创建一次）
        self.init_thumbnail_toolbar()
        # 用于定时更新缩略图的定时器
        self.thumbnail_timer = QTimer(self)
        self.thumbnail_timer.timeout.connect(self.update_taskbar_thumbnail)

    def init_thumbnail_toolbar(self):
        """初始化任务栏缩略图工具栏，添加播放/停止按钮"""
        self.thumbbar = QWinThumbnailToolBar(self)
        self.thumbbar.setWindow(self.windowHandle())

        # 播放按钮
        play_btn = QWinThumbnailToolButton()
        play_btn.setIcon(self.style().standardIcon(QStyle.SP_MediaPlay))
        play_btn.clicked.connect(self.player.play)

        # 停止按钮
        stop_btn = QWinThumbnailToolButton()
        stop_btn.setIcon(self.style().standardIcon(QStyle.SP_MediaStop))
        stop_btn.clicked.connect(self.onclose)

        self.thumbbar.addButton(play_btn)
        self.thumbbar.addButton(stop_btn)

    def start_playback(self):
        """开始播放，启动缩略图更新定时器"""
        self.videoframe.show()
        self.player.play()
        # 每100ms更新一次缩略图，平衡性能和流畅度
        self.thumbnail_timer.start(100)

    def onclose(self):
        """停止播放，清理资源并更新缩略图"""
        if self.player:
            self.player.stop()
            self.videoframe.hide()
            self.thumbnail_timer.stop()
            # 停止后强制更新一次缩略图
            self.update_taskbar_thumbnail()

    def update_taskbar_thumbnail(self):
        """截取整个窗口内容，设置为任务栏缩略图"""
        # 捕获当前窗口的完整截图（包括按钮和视频区域）
        window_pixmap = self.grab()
        # 将截图设置为任务栏缩略图
        QtWin.setThumbnailPixmap(self.windowHandle(), window_pixmap)

    def showEvent(self, event):
        """窗口显示时更新一次缩略图"""
        super().showEvent(event)
        self.update_taskbar_thumbnail()

为什么这样能解决问题？ #

• 播放时：通过QTimer定期截取整个窗口的内容（包括顶部的控制按钮和视频区域），手动设置为任务栏缩略图，替代VLC接管HWND后失效的默认捕获机制。
• 停止播放后：停止定时器并强制更新一次缩略图，此时窗口截图会包含隐藏视频区域后的界面，避免缩略图变成空白。
• 缩略图工具栏：初始化时就创建工具栏并添加按钮，避免重复创建导致的问题，同时提供更便捷的任务栏控制。

注意事项 #

• 定时器的间隔可以根据需要调整（比如100ms到200ms），间隔太小会增加CPU占用，太大则缩略图更新不流畅。
• 如果你的窗口尺寸较大，grab()方法可能会有轻微性能开销，此时可以考虑只截取需要显示的区域（比如self.mainframe.grab()），而不是整个窗口。

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