Qt Multimedia GStreamer 后端

本页介绍Qt Multimedia GStreamer 后端的限制。

限制和已知问题

GStreamer 未与 Qt 捆绑，但通常与 Linux 发行版一起部署。

• 某些错误可能是由于使用的 GStreamer 版本造成的。我们建议在你的平台上使用最新的 GStreamer 错误修复版本。
• 某些错误也可能与 GStreamer 使用的库有关，如 Pulseaudio。最值得注意的是 Pulseaudio v16 有一个已知的 bug，会导致 GStreamer 管道挂起，需要使用这两个补丁的反向移植：
  • https://gitlab.freedesktop.org/pulseaudio/pulseaudio/-/merge_requests/745
  • https://gitlab.freedesktop.org/pulseaudio/pulseaudio/-/merge_requests/764

  该漏洞目前影响到大多数主流 Linux 发行版，包括 Ubuntu 22.04、23.10 和 24.04、Debian 11 和 12 以及 Fedora 39 和 40。

• 寻道、播放率、循环、切换汇集存在已知错误。
• 音频功能需要 PulseAudio。详情请参见Linux 平台说明。

自定义点

Qt Multimedia GStreamer 提供了某些自定义点，允许访问底层 GStreamer 管道。这些定制点被视为私有 API，可能会有变动。入口点是 。class QGStreamerPlatformSpecificInterface

原始管道访问

可访问QMediaPlayer 和QMediaCaptureSession 的底层GstPipeline 。

#include <QtMultimedia/private/qgstreamer_platformspecificinterface_p.h>

[...]
QMediaMediaPlayer player;
GstPipeline *pipeline = QGStreamerPlatformSpecificInterface::instance()->gstPipeline(&player);
[...]
QMediaCaptureSession session;
GstPipeline *pipeline = QGSreamerPlatformSpecificInterface::instance()->gstPipeline(&session);

自定义 GStreamer 元素作为汇和源

可以从 GStreamer 管道说明中创建 GStreamer 元素，并将它们封装在QCamera 或QAudioDevice 中：

#include <QtMultimedia/private/qgstreamer_platformspecificinterface_p.h>

[...]
QByteArray pipelineString = "videotestsrc is-live=true ! gamma gamma=2.0";

QMediaCaptureSession session;
session.setVideoSink(wid.videoSink());

QCamera *cam = QGStreamerPlatformSpecificInterface::instance()->makeCustomGStreamerCamera(
         pipelineString, &session);
session.setCamera(cam);

QMediaPlayer：自定义源

QMediaPlayer 接受 GStreamer 管道说明作为源 URI：

QMediaPlayer player;
player.setSource(u"gstreamer-pipeline: videotestsrc name=testsrc"_s);

这将尝试编译管道描述，作为QMediaPlayer 中的源，并自动连接到QMediaPlayer 的汇。

架构考虑因素

Qt Multimedia GStreamer 并非通用流框架，也不一定是将 GStreamer 与 Qt 结合使用的最佳架构方式。如果开发人员需要对 GStreamer 管道进行高度控制，但又只想在 Qt 上显示视频输出，那么他们可能会考虑使用 GStreamer 的qml6glsink。