Qt5下QMediaPlayer与QVideoWidget Windows播放正常树莓派4显示空白问题

该问题90%以上概率和树莓派上Qt5 Multimedia模块依赖的GStreamer解码后端组件缺失、配置错误有关，小概率是权限、图形驱动不兼容导致的渲染异常。

• 第一步：安装完整的GStreamer解码插件和Qt Multimedia依赖
  执行命令：

sudo apt update && sudo apt install -y gstreamer1.0-plugins-base gstreamer1.0-plugins-good gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly gstreamer1.0-libav qtmultimedia5-examples libqt5multimedia5-plugins

• 第二步：验证系统层解码能力
  执行命令测试GStreamer能否直接播放目标视频：

gst-play-1.0 /home/pi/small.mp4

如果能正常播放画面，说明解码依赖正常，问题出在Qt配置层面；如果无法播放，说明缺对应解码库，安装匹配的解码包即可。

• 第三步：补充QMediaPlayer错误监听逻辑
  你当前代码未捕获播放器错误，所以看不到异常提示，添加如下代码打印具体错误：

connect(player, QOverload<QMediaPlayer::Error>::of(&QMediaPlayer::error), this, [=](){
    qDebug() << "播放器错误：" << player->errorString();
});

• 第四步：检查运行环境配置
  你的日志存在XDG_RUNTIME_DIR not set警告，且大概率是用root账户运行GUI程序导致的权限异常：

1. 切换到默认pi用户运行程序，不要用root
2. 运行程序前先执行环境变量配置：

export XDG_RUNTIME_DIR=/run/user/$(id -u pi)
export QT_MEDIA_BACKEND=gstreamer

• 若GStreamer可正常播放视频但Qt无输出：将QVideoWidget替换为QGraphicsVideoItem做输出，避免OpenGL渲染兼容问题，示例代码如下：

QMediaPlayer *player = new QMediaPlayer;
player->setMedia(QUrl::fromLocalFile("/home/pi/small.mp4"));

QGraphicsScene *scene = new QGraphicsScene;
QGraphicsView *view = new QGraphicsView(scene);
QGraphicsVideoItem *videoItem = new QGraphicsVideoItem;
player->setVideoOutput(videoItem);
scene->addItem(videoItem);
setCentralWidget(view);
videoItem->setSize(view->size());

player->play();

• 若仍无画面：执行sudo raspi-config，进入「Advanced Options」-「GL Driver」，选择「GL (Fake KMS)」驱动，保存重启后再运行程序。

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