PySide2 QWebEngineView无法播放MP4、MKV等视频文件问题求助

核心原因分析 #

PySide2的QWebEngineView基于Chromium，Windows平台下开源版本的Chromium默认不包含H.264、MPEG-4等专利编解码器，这直接导致MKV、AVI、MOV、WMV这类依赖专利编码的格式无法播放，仅能触发下载；MP4能加载但无法播放也多是因为缺少H.264解码支持。

可行解决方案 #

• 确认Qt WebEngine版本类型：Qt提供两种WebEngine构建包，开源版不含专利编解码器，商业版包含。如果使用的是PyPI默认安装的PySide2，大概率是开源版。可尝试获取包含商业编解码器的Qt构建版本重新打包PySide2，或购买Qt商业授权。
• 安装系统级编解码器：在Windows上安装K-Lite Codec Pack这类通用编解码器包，QWebEngineView会调用系统媒体框架（如DirectShow），系统编解码器可被Chromium复用，从而支持更多格式播放。
• 检查WebEngine配置项：确保启用媒体相关设置，示例代码：

from PySide2.QtWebEngineWidgets import QWebEngineSettings

settings = QWebEngineSettings.defaultSettings()
settings.setAttribute(QWebEngineSettings.PluginsEnabled, True)
settings.setAttribute(QWebEngineSettings.FullScreenSupportEnabled, True)
settings.setAttribute(QWebEngineSettings.MediaPlaybackRequiresUserGesture, False)  # 取消用户触发播放限制

• PySide6问题的处理思路：PySide6的WebEngine同样存在开源版编解码器限制，切换后遇到的其他问题多是Qt6 API变化导致（如模块拆分、方法重命名），可对比Qt5到Qt6的迁移文档调整代码，但编解码器问题的解决逻辑和PySide2一致。
• 替代方案：若编解码器问题无法解决，可拦截视频链接，使用PySide的QMediaPlayer组件直接播放本地或网络媒体文件，需要自行处理链接解析、媒体类型判断和播放窗口嵌入逻辑。

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