PyQt6视频播放器加载视频后无画面问题求助

问题根源 #

1. 视频控件未关联targetArea：代码中将QVideoWidget直接添加到主窗口的全局布局，而非指定的targetArea容器内，导致视频画面和targetArea无关联。
2. 布局冲突：targetArea使用setGeometry手动设置位置，但主窗口central_widget同时启用了VBoxLayout，两种布局方式冲突，导致targetArea的显示位置/大小异常。
3. 媒体加载时机问题：未监听媒体加载完成状态，直接调用play()可能导致媒体未就绪就尝试播放。

修复后的完整代码 #

import sys
from PyQt6.QtWidgets import QApplication, QMainWindow, QVBoxLayout, QWidget, QPushButton, QFileDialog, QHBoxLayout
from PyQt6.QtCore import Qt, QObject, QUrl
from PyQt6.QtMultimedia import QMediaPlayer
from PyQt6.QtMultimediaWidgets import QVideoWidget
from pathlib import Path


class VideoPlayer(QObject):
    def __init__(self, ui):
        super().__init__()
        self.ui = ui

        # 关联targetArea点击事件
        self.ui.targetArea.mousePressEvent = self.on_target_area_clicked

        # 初始化媒体播放器和视频控件
        self.mediaPlayer = QMediaPlayer()
        self.videoWidget = QVideoWidget()
        
        # 将视频控件嵌入targetArea内部布局
        self.ui.targetLayout.addWidget(self.videoWidget)

        # 关联信号
        self.mediaPlayer.errorOccurred.connect(self.handle_media_error)
        self.mediaPlayer.mediaStatusChanged.connect(self.handle_media_status)
        self.mediaPlayer.setVideoOutput(self.videoWidget)

    def handle_media_error(self, error, error_string):
        print(f'媒体错误: {error_string}')

    def handle_media_status(self, status):
        # 媒体加载完成后自动播放
        if status == QMediaPlayer.MediaStatus.LoadedMedia:
            self.mediaPlayer.play()
            # 保持视频比例并适配容器
            self.videoWidget.setAspectRatioMode(Qt.AspectRatioMode.KeepAspectRatio)

    def on_target_area_clicked(self, event):
        fileDialog = QFileDialog()
        fileDialog.setNameFilter("视频文件 (*.mp4 *.avi *.mov *.wmv *.mkv *.flv *.webm *.mpeg *.mpg *.mp4v)")
        filePath, _ = fileDialog.getOpenFileName()
        if filePath:
            self.handle_selected_file(filePath)

    def handle_selected_file(self, filePath):
        supported_extensions = ['.mp4', '.avi', '.mov', '.wmv', '.mkv',
                                '.flv', '.webm', '.mpeg', '.mpg', '.mp4v']
        file_extension = Path(filePath).suffix.lower()
        if file_extension not in supported_extensions:
            print(f'不支持的格式: {file_extension}，请选择其他文件。')
        else:
            self.handle_video_loaded(filePath)

    def handle_video_loaded(self, filePath):
        mediaUrl = QUrl.fromLocalFile(filePath)
        self.mediaPlayer.setMedia(mediaUrl)


class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("视频播放器")
        self.resize(1024, 768)

        self.central_widget = QWidget()
        self.setCentralWidget(self.central_widget)

        # 主横向布局，让targetArea居中显示
        self.mainLayout = QHBoxLayout(self.central_widget)
        self.mainLayout.addStretch(1)

        # 创建targetArea容器并设置固定尺寸
        self.targetArea = QWidget()
        self.targetArea.setFixedSize(520, 400)
        self.targetArea.setObjectName("targetArea")
        # 给targetArea添加内部布局，用于嵌入视频控件
        self.targetLayout = QVBoxLayout(self.targetArea)
        self.targetLayout.setContentsMargins(0, 0, 0, 0)  # 去掉内边距，让视频填满容器

        self.mainLayout.addWidget(self.targetArea)
        self.mainLayout.addStretch(1)

        # 底部添加打开按钮
        self.buttonLayout = QVBoxLayout()
        self.open_button = QPushButton("打开视频文件")
        self.buttonLayout.addWidget(self.open_button)
        self.mainLayout.addLayout(self.buttonLayout)

        # 初始化播放器
        self.video_player = VideoPlayer(self)
        self.open_button.clicked.connect(self.video_player.on_target_area_clicked)


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

关键修改说明 #

• 嵌入视频控件到targetArea：给targetArea添加内部布局，将QVideoWidget加入该布局，确保视频画面严格显示在targetArea范围内。
• 修复布局冲突：移除setGeometry，改用setFixedSize固定targetArea尺寸，并通过主布局的addStretch实现居中效果。
• 添加状态监听：监听mediaStatusChanged信号，在媒体加载完成后再执行播放，避免未就绪导致的播放失败。
• 适配视频比例：设置视频控件的比例模式，确保视频按原比例显示且填满容器。

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