qvideowidget适合简单直连播放，响应快但功能受限；qgraphicsvideoitem支持图形叠加、变换等高级渲染，需挂入qgraphicsscene，适用于画中画、滤镜等场景。
Qt里用QVideoWidget还是QGraphicsVideoItem？
直接用 QVideoWidget 最简单，但只支持单一视频输出、不支持叠加图形或自定义渲染；如果要做画中画、加滤镜、或和 QGraphicsView 场景混用，得换 QGraphicsVideoItem。两者底层都依赖 Qt Multimedia 的播放管线，但 QVideoWidget 是 QWidget 子类，QGraphicsVideoItem 必须挂到 QGraphicsScene 里——别硬塞进普通布局，会崩溃。
-
QVideoWidget适合桌面端主窗口直连摄像头或文件流，响应快、开箱即用 -
QGraphicsVideoItem适合需要缩放/旋转/遮罩/图层混合的场景，但帧率略低，且必须调用scene->addItem()才能显示 - Qt 6.5+ 已废弃
QMediaPlayer+QVideoWidget组合，改用QMediaCaptureSession+QVideoSink（尤其对 USB 摄像头）
用OpenCV捕获视频再喂给Qt显示，怎么避免卡顿？
别在主线程里用 cv::VideoCapture::read() 循环拉帧——UI 会冻住。必须把采集和转换放到独立线程，用信号把 cv::Mat 推给 UI 线程。关键点是：Mat 数据不能跨线程裸传，要转成 QImage 或用 QSharedMemory 共享内存；否则频繁深拷贝吃光 CPU。
- 推荐方案：Worker 线程里用
cv::Mat读帧 → 调用cv::cvtColor()转 BGR2RGB → 构造QImage（注意QImage构造函数第四个参数必须传QImage::Format_RGB888，否则颜色错乱） - 千万避开
QImage::fromMat()—— 它默认按 BGR 解析，Qt 5.12+ 才支持自动识别，旧版本必花屏 - 每帧生成新
QImage后，用QPixmap::fromImage()赋给QLabel，别反复调用setPixmap()大图——先QPixmap::scaled()再设，否则缩放拖慢主线程
Qt 6 下 QMediaDevices::defaultVideoInput() 返回空列表怎么办？
不是没摄像头，是权限或后端没启。Linux 上缺 libavcodec 或 gstreamer 插件，Windows 上没装 qtmultimedia 的 WinRT 后端，macOS 则需在 Info.plist 加 NSCameraUsageDescription。Qt 6.2+ 默认禁用 GStreamer，得手动编译时打开 -DQT_MULTIMEDIA_WANT_GSTREAMER=ON 或改用 ffmpeg 后端。
- 检查命令行输出有没有
qt.qpa.plugin: Could not load the Qt platform plugin "xcb"类错误——平台插件缺失会导致设备枚举失败 - 运行
qtmultimedia自带的camera示例程序，看是否能列出设备；不行就说明环境配置没过 - 若用 USB 摄像头，确认
/dev/video0可读（Linux），或设备管理器里没黄叹号（Windows）
实时流延迟超过 500ms，怎么压？
延迟主要卡在三处：采集缓冲区、解码队列、Qt 渲染管线。Qt 默认启用帧队列缓存，QMediaRecorder 或 QVideoSink 都有 setVideoFrameRate() 和 setBufferDuration() 可调，但最有效的是关掉无谓的中间处理。
- 采集端：OpenCV 用
cap.set(cv::CAP_PROP_BUFFERSIZE, 1)强制单帧缓冲；Qt 原生采集设QMediaCaptureSession::setVideoOutput()前，先videoSink->setMaximumFrameRate(30) - 别在每一帧上做
QImage::mirrored()或QPainter绘制——这些操作同步阻塞渲染线程，改用QGraphicsVideoItem::setMirror()或 Shader 处理 - QWidget 窗口开启
setAttribute(Qt::WA_PaintOnScreen, true)有时能减 2–3 帧延迟，但仅限嵌入式或特定显卡驱动下有效，桌面端慎用
真正低延迟（
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
