PySide6中QMediaPlayer调用setSource()切换媒体异常求助

问题分析 #

1. 直接在槽函数中切换媒体源的问题 #

你的第一个实现中，mediaStatusChanged信号会在媒体状态变化时多次触发（比如加载中、就绪、播放结束等），但代码没有判断具体状态就执行setSource，不仅会导致不必要的切换，而且setSource加载媒体的操作是同步阻塞的，会卡住主线程，造成窗口卡顿。

2. 子线程切换媒体源的问题 #

Qt的QMediaPlayer属于主线程绑定的类，所有成员方法必须在主线程调用，子线程中调用会引发线程安全问题，导致程序异常。另外，QThread对象只能被启动一次，第二次调用start()会无效，这就是1.mp4播放结束后程序无响应的原因。

正确解决方案：使用QMediaPlaylist管理播放列表 #

Qt提供了QMediaPlaylist专门用于管理媒体播放队列，它会自动处理媒体切换，且内部采用异步加载逻辑，不会阻塞主线程，完美解决卡顿和切换问题。

完整代码示例 #

import sys
from PySide6.QtCore import QUrl
from PySide6.QtWidgets import QApplication, QMainWindow
from PySide6.QtMultimedia import QAudioOutput, QMediaPlayer, QMediaPlaylist
from PySide6.QtMultimediaWidgets import QVideoWidget

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()

        self._audio_output = QAudioOutput()
        self._player = QMediaPlayer()
        self._player.setAudioOutput(self._audio_output)

        # 创建播放列表
        self._playlist = QMediaPlaylist()
        # 添加视频文件（替换video_count为你的视频总数）
        video_count = 3
        for i in range(video_count):
            self._playlist.addMedia(QUrl.fromLocalFile(f"./{i}.mp4"))
        
        # 设置播放模式：顺序播放到末尾停止，可改为QMediaPlaylist.Loop实现循环播放
        self._playlist.setPlaybackMode(QMediaPlaylist.Sequential)
        
        # 将播放列表绑定到播放器
        self._player.setPlaylist(self._playlist)

        self._video_widget = QVideoWidget()
        self.setCentralWidget(self._video_widget)
        self._player.setVideoOutput(self._video_widget)

        # 开始播放
        self._player.play()

if __name__ == '__main__':
    app = QApplication(sys.argv)
    main_win = MainWindow()
    available_geometry = main_win.screen().availableGeometry()
    main_win.resize(available_geometry.width() / 3,
                    available_geometry.height() / 2)
    main_win.show()
    sys.exit(app.exec())

关键说明 #

• QMediaPlaylist会自动预加载下一个媒体文件，切换时几乎无延迟，不会阻塞主线程。
• 可通过setPlaybackMode设置播放模式：
  • QMediaPlaylist.Sequential：顺序播放，播放完最后一个停止
  • QMediaPlaylist.Loop：循环播放所有媒体
  • QMediaPlaylist.CurrentItemLoop：循环播放当前媒体
• 如果需要动态添加/移除视频，直接调用addMedia/removeMedia方法即可，无需手动处理切换逻辑。

备选方案：优化手动切换逻辑（不推荐） #

如果不想使用播放列表，可优化原代码，仅在EndOfMedia状态时切换，并确保媒体加载就绪后再播放：

import sys
from PySide6.QtCore import Slot, QUrl
from PySide6.QtWidgets import QApplication, QMainWindow
from PySide6.QtMultimedia import QAudioOutput, QMediaPlayer
from PySide6.QtMultimediaWidgets import QVideoWidget

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()

        self._audio_output = QAudioOutput()
        self._player = QMediaPlayer()
        self._player.setAudioOutput(self._audio_output)

        self._video_widget = QVideoWidget()
        self.setCentralWidget(self._video_widget)
        self._player.setVideoOutput(self._video_widget)
        self.video_now = 0

        # 首次加载并播放
        self.load_and_play()

        # 监听媒体状态变化
        self._player.mediaStatusChanged.connect(self.on_media_status_changed)

    def load_and_play(self):
        self._player.setSource(QUrl.fromLocalFile(f"./{self.video_now}.mp4"))
        self.video_now += 1

    @Slot(QMediaPlayer.MediaStatus)
    def on_media_status_changed(self, status):
        # 仅在播放结束时切换下一个
        if status == QMediaPlayer.MediaStatus.EndOfMedia:
            self.load_and_play()
        # 媒体加载就绪后自动播放
        elif status == QMediaPlayer.MediaStatus.LoadedMedia:
            self._player.play()

if __name__ == '__main__':
    app = QApplication(sys.argv)
    main_win = MainWindow()
    available_geometry = main_win.screen().availableGeometry()
    main_win.resize(available_geometry.width() / 3,
                    available_geometry.height() / 2)
    main_win.show()
    sys.exit(app.exec())

这个方案通过拆分加载和播放逻辑，避免了直接在结束状态下立即播放未就绪的媒体，但仍不如QMediaPlaylist高效稳定。

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