Qt Designer中如何实现点击按钮调用OpenCV播放本地MP4视频？

cv2代码提前执行问题修复 #

你遇到的cv2逻辑优先执行，基本都是因为两种错误写法：

1. 把cv2播放逻辑直接写在了全局作用域，脚本启动就会按顺序执行
2. 给按钮绑定点击事件时，槽函数加了括号，导致初始化时直接触发函数执行

正确实现示例 #

不要直接修改Qt Designer生成的UI文件，新建主逻辑文件继承UI类，把播放逻辑封装为独立槽函数，仅在按钮点击时触发：

from PyQt5.QtWidgets import QMainWindow, QApplication
from ui_main import Ui_MainWindow # 替换为你自己生成的UI类名
import cv2
import sys

class MainWindow(QMainWindow, Ui_MainWindow):
    def __init__(self):
        super().__init__()
        self.setupUi(self)
        # 绑定按钮点击信号到槽函数，*槽函数名后不要加括号*，否则会直接执行
        self.playBtn.clicked.connect(self.cv2_play_video)
    
    def cv2_play_video(self):
        # 所有cv2播放逻辑全部放在该槽函数内，仅点击按钮时触发
        cap = cv2.VideoCapture("demo.mp4") # 同目录下的目标视频
        while cap.isOpened():
            ret, frame = cap.read()
            if not ret:
                break
            cv2.imshow("Video Playback", frame)
            # 按Q键可提前退出播放
            if cv2.waitKey(25) & 0xFF == ord('q'):
                break
        cap.release()
        cv2.destroyAllWindows()

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MainWindow()
    window.show()
    sys.exit(app.exec_())

其他本地MP4播放方案 #

下面是几种适配Qt项目的常见方案，无需引入外部工具：

• Qt Multimedia模块（首选）
  Qt官方自带的多媒体组件，和Qt UI兼容性最高，支持直接把视频渲染到UI内嵌控件，无需弹出独立窗口，解码能力比OpenCV强，还自带音频播放支持。需要先安装对应依赖：PyQt5安装PyQt5-Multimedia，PyQt6安装PyQt6-Multimedia。
  核心逻辑参考：

  from PyQt5.QtMultimedia import QMediaPlayer, QMediaContent
  from PyQt5.QtCore import QUrl
  
  # 槽函数实现
  def qt_play_video(self):
      self.media_player = QMediaPlayer()
      # 绑定到UI中提前放置的QVideoWidget控件，实现内嵌播放
      self.media_player.setVideoOutput(self.videoWidget)
      # 加载同目录视频
      media_content = QMediaContent(QUrl.fromLocalFile("demo.mp4"))
      self.media_player.setMedia(media_content)
      self.media_player.play()
  

• ffpyplayer库
  基于FFmpeg的开源播放库，支持几乎所有主流音视频格式，解码能力强，可配合OpenCV读取帧后渲染到Qt控件上，安装命令为pip install ffpyplayer
• OpenCV+QLabel内嵌播放
  如果不想引入额外依赖，可将OpenCV读取的每帧视频转换为QImage格式，直接渲染到UI内的QLabel控件上，无需弹出独立的cv2窗口，交互体验更好

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