Windows下PyQt5 QMediaPlayer仅支持WMV？如何扩展格式支持？

场景描述 #

我想在Qt GUI中实现视频预览功能，用PyQt5的QMediaPlayer写了测试代码，能正常播放WMV格式视频，但H264 MPEG4 AVC编码的视频会报InvalidMedia错误——这些视频用VLC可以正常播放。我怀疑Windows下QMediaPlayer仅支持WMF文件，想确认：

• 这个结论是否正确？
• 能不能通过安装编码包扩展支持格式？
• 如何让PyQt5识别H264编码？

测试代码 #

from PyQt5.QtCore import *
from PyQt5.QtGui import *
from PyQt5.QtWidgets import *
from PyQt5.QtMultimedia import *
from PyQt5.QtMultimediaWidgets import *

class VideoPlayer(QWidget):
    def __init__(self, parent=None):
        super(VideoPlayer, self).__init__(parent)
        videoItem = QGraphicsVideoItem()
        videoItem.setSize(QSizeF(640, 480))
        scene = QGraphicsScene(self)
        scene.addItem(videoItem)
        graphicsView = QGraphicsView(scene)
        layout = QVBoxLayout()
        layout.addWidget(graphicsView)
        self.setLayout(layout)
        self.mediaPlayer = QMediaPlayer(None, QMediaPlayer.VideoSurface)
        self.mediaPlayer.setVideoOutput(videoItem)

    def keyPressEvent(self, e):
        if e.key() == Qt.Key_L:
            print('loading')
            self.load()
        if e.key() == Qt.Key_P:
            print('playing')
            self.mediaPlayer.play()
        print('state: ' + str(self.mediaPlayer.state()))
        print('mediaStatus: ' + str(self.mediaPlayer.mediaStatus()))
        print('error: ' + str(self.mediaPlayer.error()))
        print('------------------------')


    def load(self):
        # H264 MPEG4 AVC not working
        file = 'C:/Users/Antonio/Videos/test.wmv'
        local = QUrl.fromLocalFile(file)
        media = QMediaContent(local)
        self.mediaPlayer.setMedia(media)

if __name__ == '__main__':
    import sys
    app = QApplication(sys.argv)
    player = VideoPlayer()
    player.show()
    sys.exit(app.exec_())

解答 #

1. Windows下QMediaPlayer仅支持WMF文件？结论不准确 #

Windows上QMediaPlayer默认使用**Windows Media Foundation (WMF)**作为后端，但WMF本身支持的格式不止WMV：原生支持H.264视频（AVC）和AAC音频，前提是系统中存在对应的解码组件。你遇到的问题大概率是系统缺少H.264的解码支持，或者视频的封装格式（比如MP4、MKV）不在WMF的默认支持列表内。

2. 可以通过安装编码包扩展支持吗？ #

可以，但效果依赖于编码包和Qt的后端实现：

• 安装系统级编码包（如K-Lite Codec Pack），部分解码组件会被WMF调用，能扩展QMediaPlayer的支持格式。注意选择“Full”或“Standard”版本，确保包含H.264的解码组件。
• 但这种方式不保证100%生效，因为Qt对WMF的调用有封装限制，不是所有系统编码都能被识别。

3. 更可靠的解决方案：切换Qt多媒体后端 #

如果系统级编码包无效，最稳定的方法是让Qt使用FFmpeg作为多媒体后端——FFmpeg对H.264等主流格式的支持非常完善。

操作步骤：

• 安装带FFmpeg支持的PyQt5：标准PyQt5默认未携带FFmpeg后端，可通过pip install pyqt5-ffmpeg安装第三方打包好的版本（注意兼容性），或者自行编译带FFmpeg支持的PyQt5。
• 强制使用FFmpeg后端：在代码开头添加环境变量配置：

  import os
  os.environ['QT_MULTIMEDIA_PREFERRED_PLUGINS'] = 'ffmpeg'
  

  配置后，QMediaPlayer即可直接播放H264编码的视频，无需额外安装系统编码包。

备选方案：使用QVLCWidget #

如果上述方法嫌麻烦，直接使用绑定VLC的python-vlc库——VLC自带所有主流编码的解码器，兼容性拉满：

1. 安装库：pip install python-vlc
2. 将视频播放组件替换为QVLCWidget，代码结构与QMediaPlayer类似，无需担心编码问题。

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