Chromium/PyQt5的MP4支持问题：如何让QtWebEngine播放MP4及MPEG音频？

我之前帮不少开发者解决过类似的问题，这类播放失败通常和Chromium的媒体编解码器支持密切相关——你调整请求头的思路其实没触碰到核心问题，下面给你几个针对性的解决方案：

• 先确认编解码器是否是问题根源
  Chromium对MP4（H.264）、MPEG音频的支持依赖专利编解码器，很多开源版Qt预编译包默认不带这些组件（受版权限制）。你可以先查看QtWebEngine控制台的日志，如果出现No supported audio format或Media resource could not be decoded这类提示，基本可以确定是编解码器缺失导致的。

• 重新编译QtWebEngine并启用专利编解码器
  如果你是Qt商业授权用户，可以自行编译QtWebEngine，编译时加上启用专利编解码器的参数：

  ./configure -commercial -webengine-proprietary-codecs
  

  编译完成后替换现有Qt库，再测试应用的媒体播放功能。如果是开源项目，可能需要考虑使用开源替代格式，或者寻找第三方预编译的带编解码器的Qt包。

• Linux系统下补充系统媒体库
  在Debian/Ubuntu这类Linux发行版上，QtWebEngine会依赖系统的Chromium媒体组件，你可以安装额外的编解码包：

  sudo apt install ffmpeg chromium-codecs-ffmpeg-extra
  

  安装完成后重启你的应用，大概率能解决SoundCloud、Pandora这类平台的音频播放问题。

• 强制使用系统媒体栈
  有时候QtWebEngine默认的媒体栈会有兼容性问题，你可以通过环境变量强制它使用系统的FFmpeg或GStreamer：

  # 使用系统FFmpeg
  export QTWEBENGINE_CHROMIUM_FLAGS="--use-system-ffmpeg"
  # 或者使用GStreamer
  export QTWEBENGINE_CHROMIUM_FLAGS="--enable-gstreamer"
  

  在启动你的应用前设置这个环境变量，再测试播放效果。

• 检查应用的WebEngine配置
  确保你的应用里启用了必要的媒体相关设置：

  QWebEngineSettings* settings = QWebEngineProfile::defaultProfile()->settings();
  settings->setAttribute(QWebEngineSettings::PluginsEnabled, true);
  settings->setAttribute(QWebEngineSettings::MediaPlaybackRequiresUserGesture, false);
  

  注意：有些平台要求媒体播放必须由用户手势（比如点击）触发，如果你的应用是自动播放音频，需要禁用MediaPlaybackRequiresUserGesture这个设置。

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