如何调试Qt QMediaPlayer连接RTSP流时的无效参数错误？

环境信息 #

• Qt 6.6
• Windows 10
• FFmpeg 6.0

FFmpeg推流命令 #

ffmpeg -f gdigrab -framerate 30 -probesize 100M -i title="" -c:v libx264 -preset veryfast -maxrate 1000k -bufsize 1000k -pix_fmt yuv420p -g 50 -c:a aac -b:a 128k -f rtsp -rtsp_transport udp rtsp://...129:8554/stream

Qt中遇到的问题 #

调用player->setSource(QUrl("rtsp://....129:8554/stream"))时卡顿数秒，随后出现调试日志：

qt.multimedia.ffmpeg.mediadataholder: AVStream duration -9223372036854775808 is invalid. Taking it from the metadata

同时QMediaPlayer::errorOccurred信号输出：

Error: "Invalid argument"

注：相同RTSP流在VLC中可正常播放

自定义MediaPlayer类实现 #

class MediaPlayer : public QObject
{
    Q_OBJECT
public:
    MediaPlayer (QObject* parent = nullptr) : QObject(parent)
    {
        player = new QMediaPlayer;
        player->setSource(QUrl("rtsp://....129:8554/stream"));
        connect(player, &QMediaPlayer::errorOccurred, this, [this](QMediaPlayer::Error error, const QString& errorString)
        {
            qDebug() << "Error:" << errorString;
        });

        videoWidget = new QVideoWidget;
        player->setVideoOutput(videoWidget);

        videoWidget->show();
        player->play();
    }

private:
    QMediaPlayer* player;
    QVideoWidget* videoWidget;
};

调试步骤建议 #

• 调整RTSP传输协议：Qt默认可能用TCP传输，显式指定UDP适配推流配置。可以通过设置环境变量QT_MULTIMEDIA_FFMPEG_RTSP_TRANSPORT=udp，或者在代码中添加低延迟选项：

  QMediaPlayer::MediaOptions options;
  options.setFlag(QMediaPlayer::MediaOption::LowLatency);
  player->setSource(QUrl("rtsp://....129:8554/stream"), options);
  

• 修正FFmpeg推流元数据：日志提示时长无效，推流时添加元数据标记无限流，避免Qt解析出错：

  ffmpeg -f gdigrab -framerate 30 -probesize 100M -i title="" -c:v libx264 -preset veryfast -maxrate 1000k -bufsize 1000k -pix_fmt yuv420p -g 50 -c:a aac -b:a 128k -metadata duration=0 -f rtsp -rtsp_transport udp rtsp://...129:8554/stream
  

• 调整Qt媒体加载顺序：改为异步加载，等待媒体资源加载完成后再播放，避免初始化顺序问题：

  MediaPlayer (QObject* parent = nullptr) : QObject(parent)
  {
      player = new QMediaPlayer;
      videoWidget = new QVideoWidget;
      player->setVideoOutput(videoWidget);
      videoWidget->show();
  
      connect(player, &QMediaPlayer::mediaStatusChanged, this, [this](QMediaPlayer::MediaStatus status) {
          if (status == QMediaPlayer::LoadedMedia) {
              player->play();
          }
      });
      connect(player, &QMediaPlayer::errorOccurred, this, [this](QMediaPlayer::Error error, const QString& errorString) {
          qDebug() << "Error:" << errorString;
      });
  
      player->setSource(QUrl("rtsp://....129:8554/stream"));
  }
  

• 启用FFmpeg详细日志：设置环境变量QT_MULTIMEDIA_FFMPEG_DEBUG=1，查看更详细的解码日志，定位具体参数错误。
• 测试简化RTSP流：用FFmpeg推送一个极简测试流，排除原推流的兼容性问题：

  ffmpeg -f lavfi -i testsrc=size=640x480:rate=30 -c:v libx264 -preset veryfast -f rtsp -rtsp_transport udp rtsp://localhost:8554/teststream
  

  若该流能被Qt正常播放，说明原推流参数存在兼容性问题；若仍报错，需检查Qt多媒体环境配置。
• 确认Qt多媒体后端：通过qDebug() << player->backendName();查看后端名称，确保使用的是ffmpeg后端，若不是需重新安装或编译对应多媒体插件。

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