使用PySimpleGUI+OpenCV开发视频播放器时图像无法显示且程序崩溃的问题求助

我仔细看了你的代码，问题根源其实不是那两行图像转换的代码，而是嵌套的while循环阻塞了PySimpleGUI的主事件循环！

问题分析 #

当你点击「Read」按钮后，代码进入了while cap.isOpened()的循环，这个循环会一直霸占主线程，疯狂读取视频帧并更新图像，但完全不给PySimpleGUI的window.read()留机会处理系统事件（比如窗口拖动、关闭、按钮点击）。系统发现GUI长时间无响应，就会判定程序崩溃，直接终止它。

另外，用cv.imencode('.png', frame)转换帧效率也偏低，换成JPEG格式能减少数据量，提升更新流畅度。

解决方案 #

把视频播放逻辑整合到PySimpleGUI的主事件循环里，利用window.read(timeout=xxx)的超时机制来实现非阻塞的帧更新——这样既能按时刷新视频画面，又能让GUI正常处理用户操作。

具体要做这几个修改：

• 把视频捕获对象cap和播放状态标志放到主循环外
• 用window.read(timeout=20)（约50fps，可根据视频帧率调整）来驱动主循环，定期检查是否需要播放帧
• 点击「Read」时初始化视频捕获，设置播放状态为True；关闭窗口或取消时释放视频资源

修改后的完整代码 #

import PySimpleGUI as sg
import cv2 as cv
import os
from pathlib import Path

sg.theme('Dark Blue 3')
file_types = [("MP4 (*.mp4)", "*.mp4"), ("AVI (*.avi)", "*.avi"), ("All files (*.*)", "*.*")]

def main():
    read_layout = [
        [sg.Text("Video File Path"), sg.InputText(key='-input_file-', enable_events=True), 
         sg.FileBrowse('Browse', key='-file-', target="-input_file-")],
        [sg.Button('Read', key='-Read-'), sg.Button('Stop', key='-Stop-'), sg.Cancel()]
    ]
    preview_video = [[sg.Image(filename='', expand_x=True, expand_y=True, key='-preview_video-')]]
    layout_tot = [
        [sg.Frame(title='Control', layout=read_layout)], 
        [sg.Frame(title='Preview', layout=preview_video)]
    ]
    window = sg.Window('Lab Project', layout_tot, location=(10, 10), alpha_channel=1.0, 
                       no_titlebar=False, resizable=True, grab_anywhere=False).Finalize()

    cap = None
    is_playing = False

    while True:
        # 用timeout实现定时刷新，20ms对应约50fps，可根据视频实际帧率调整
        event, values = window.read(timeout=20)
        
        if event == sg.WIN_CLOSED or event == "Cancel":
            # 释放视频资源后再关闭窗口
            if cap is not None:
                cap.release()
            break
        
        elif event == "-Read-":
            read_path1 = Path(values['-input_file-'])
            if os.path.exists(read_path1):
                # 先释放之前的视频资源
                if cap is not None:
                    cap.release()
                # 初始化新的视频捕获
                cap = cv.VideoCapture(str(read_path1))
                if not cap.isOpened():
                    print("Cannot open video file")
                    cap = None
                    is_playing = False
                else:
                    is_playing = True
                    print(f"Playing video: {values['-input_file-']}")
        
        elif event == "-Stop-":
            is_playing = False
            if cap is not None:
                cap.release()
                cap = None
            # 清空预览区域
            window['-preview_video-'].update(data=None)
        
        # 如果处于播放状态，读取并更新帧
        if is_playing and cap is not None:
            ret, frame = cap.read()
            if not ret:
                print("Video playback finished")
                is_playing = False
                cap.release()
                cap = None
                window['-preview_video-'].update(data=None)
            else:
                # 转换为JPEG格式，比PNG效率更高
                imgbytes = cv.imencode('.jpg', frame, [cv.IMWRITE_JPEG_QUALITY, 80])[1].tobytes()
                window['-preview_video-'].update(data=imgbytes)

    window.close()

if __name__ == "__main__":
    main()

关键改进点 #

1. 避免阻塞主事件循环：用window.read(timeout=20)替代嵌套循环，让GUI能同时处理用户操作和视频刷新
2. 资源管理：每次打开新视频或停止播放时，及时释放之前的cap对象，避免内存泄漏
3. 效率优化：改用JPEG格式编码帧数据，减少传输的数据量，提升刷新流畅度
4. 状态控制：新增is_playing标志，更灵活地控制视频的播放和暂停

这样修改后，你的视频播放器就能正常运行，不会再出现窗口卡死崩溃的问题了！

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