QMediaPlayer需搭配QAudioOutput和QVideoWidget才能正常播放音视频；Qt 6强制要求显式绑定QAudioOutput并设音量，视频输出须用QUrl::fromLocalFile()传路径，否则静音或黑屏。
QMediaPlayer 是 Qt 里播放音视频最直接的入口，但它本身不显示画面、也不发声——得配 QAudioOutput 和 QVideoWidget 才能真正跑起来。
QMediaPlayer 必须搭配 QAudioOutput 才有声音（Qt 6 强制要求）
Qt 6 把音频输出彻底解耦了：QMediaPlayer 不再内置音频设备管理，必须显式创建 QAudioOutput 并用 setAudioOutput() 绑定，否则静音是默认行为，不是 bug。
- 如果漏掉这步，播放 MP4/AVI 等带音频的视频时，画面可能正常，但完全没声
-
QAudioOutput需要手动设音量（setVolume(0.7)），默认是 0 - 不同平台后端不同（Windows 用 WMF，Linux 常用 GStreamer），但只要系统装了对应后端，
QAudioOutput就能自动选，不用你干预
QAudioOutput *audioOutput = new QAudioOutput(this); audioOutput->setVolume(0.7); player->setAudioOutput(audioOutput);
视频显示必须指定输出目标，QVideoWidget 最省事但有局限
QVideoWidget 是 Qt 自带的视频渲染控件，适合快速原型或简单播放器：
- 它必须设置父容器（比如一个
QFrame或QWidget），且要手动调resize()或重写resizeEvent()来适配窗口变化 - 黑屏常见原因：父容器没 show()、
QVideoWidget没 setParent()、或setVideoOutput()调用晚于setSource() - 它不支持 OpenGL 渲染、无法自定义帧处理（如加滤镜）、缩放拉伸逻辑也较死板
QVideoWidget *videoWidget = new QVideoWidget(parentWidget); videoWidget->setAspectRatioMode(Qt::KeepAspectRatio); player->setVideoOutput(videoWidget);
如果需要更灵活控制（比如全屏抗锯齿、YUV 直接渲染、画中画），就得换 QGraphicsVideoItem 或自己继承 QAbstractVideoSink。
文件路径传给 setSource() 时，必须用 QUrl::fromLocalFile()
直接传 QString 路径（比如 "C:/test.mp4"）会失败，QMediaPlayer 内部按 URL 解析，本地文件必须包装：
- Windows 下路径含中文或空格时，不包装会导致
Invalid argument错误 -
QUrl::fromLocalFile()会自动做 percent-encode，而QUrl("file:///C:/test.mp4")手动拼容易出错 - 网络流（如 RTSP）则用
QUrl("rtsp://...")，不用 fromLocalFile
QString path = QFileDialog::getOpenFileName(this, "选择视频");
if (!path.isEmpty()) {
player->setSource(QUrl::fromLocalFile(path)); // ✅ 正确
// player->setSource(QUrl(path)); ❌ 大概率失败
}
Qt 的音视频播放不是“设个路径就完事”，关键链路是：QMediaPlayer →（音频）→ QAudioOutput →（视频）→ QVideoWidget / QGraphicsVideoItem
中间任意一环缺失或顺序错乱，都会表现为无声、黑屏、卡顿或报错 QMediaPlayer::InvalidMedia。
尤其是 Qt 6 后，QAudioOutput 已成硬性依赖，老代码迁移到 Qt 6 时最容易栽在这儿。
