如何实现QMediaPlayer调用play()后立即播放带音频的视频？

我用QMediaPlayer把带音频的视频输出到QVideoWidget里，播放无音频视频时调用player.play()会立即开始，但播放带音频的视频要等好几秒才启动。有没有办法让带音频的视频调用play()后立刻播放？

我试过预缓冲的方法，但出现了"failed to seek"错误。

环境：Ubuntu 23.04、Python 3.11、PyQt5

示例代码：

from PyQt5.QtWidgets import QApplication, QMainWindow, QWizard, QWizardPage, QPushButton, QVBoxLayout
from PyQt5.QtMultimedia import QMediaPlayer, QMediaContent
from PyQt5.QtCore import QUrl
from PyQt5.QtMultimediaWidgets import QVideoWidget


class VideoPage(QWizardPage):
    def __init__(self):
        super().__init__()

        layout = QVBoxLayout()
        self.setLayout(layout)

        self.player = QMediaPlayer(self)
        self.media_content = QMediaContent(QUrl.fromLocalFile('path/to/vid.mp4'))
        self.player.setMedia(self.media_content)
        self.video = QVideoWidget()
        self.player.setVideoOutput(self.video)
        
        play_button = QPushButton('Play Video')
        play_button.clicked.connect(self.play_video)
        layout.addWidget(self.video)
        layout.addWidget(play_button)

    def play_video(self):
        self.player.play()

if __name__ == '__main__':
    import sys
    app = QApplication(sys.argv)
    wizard = QWizard()
    video_page = VideoPage()
    wizard.addPage(video_page)
    wizard.setWindowTitle('Video Wizard')
    wizard.show()
    sys.exit(app.exec_())

带音频的视频启动慢，本质是QMediaPlayer需要时间解码音频流并完成初始化。可以通过提前预加载媒体并等待加载完成实现点击播放后立即启动，同时避免"failed to seek"错误。

核心思路 #

之前的"failed to seek"错误是因为媒体未加载完成就执行seek操作，所以必须等媒体进入LoadedMedia状态后再做预缓冲处理。预缓冲时通过短暂播放再暂停，让播放器完成音视频流的解码初始化，后续真正播放时无需再等待准备时间。

修改后的代码 #

from PyQt5.QtWidgets import QApplication, QWizard, QWizardPage, QPushButton, QVBoxLayout
from PyQt5.QtMultimedia import QMediaPlayer, QMediaContent
from PyQt5.QtCore import QUrl


class VideoPage(QWizardPage):
    def __init__(self):
        super().__init__()

        layout = QVBoxLayout()
        self.setLayout(layout)

        self.player = QMediaPlayer(self)
        # 针对本地文件设置低延迟缓冲模式，优先保证启动速度
        self.player.setBufferMode(QMediaPlayer.LowLatencyBufferMode)
        self.media_content = QMediaContent(QUrl.fromLocalFile('path/to/vid.mp4'))
        self.player.setMedia(self.media_content)
        self.video = QVideoWidget()
        self.player.setVideoOutput(self.video)
        
        play_button = QPushButton('Play Video')
        play_button.clicked.connect(self.play_video)
        layout.addWidget(self.video)
        layout.addWidget(play_button)

        # 监听媒体状态变化，完成预加载初始化
        self.player.mediaStatusChanged.connect(self.on_media_loaded)

    def on_media_loaded(self, status):
        # 媒体加载完成后，触发一次播放再暂停，完成解码初始化
        if status == QMediaPlayer.LoadedMedia:
            self.player.play()
            self.player.pause()
            self.player.setPosition(0)  # 确保进度回到开头

    def play_video(self):
        # 根据当前状态处理，避免无效操作
        if self.player.state() == QMediaPlayer.PausedState:
            self.player.play()
        else:
            self.player.play()

if __name__ == '__main__':
    import sys
    app = QApplication(sys.argv)
    wizard = QWizard()
    video_page = VideoPage()
    wizard.addPage(video_page)
    wizard.setWindowTitle('Video Wizard')
    wizard.show()
    sys.exit(app.exec_())

额外优化说明 #

• LowLatencyBufferMode：针对本地媒体文件，该模式会减少缓冲时长，优先保障启动速度；
• 预加载的play()+pause()：让播放器提前完成音视频解码的初始化工作，后续播放无需再等待；
• 状态判断：播放按钮点击时根据播放器当前状态处理，避免重复触发无效操作。

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