Qt Multimedia GStreamerバックエンド

このページでは、Qt Multimedia の GStreamer バックエンドの制限について説明します。

制限と既知の問題

GStreamer は Qt にバンドルされていませんが、通常 Linux ディストリビューションに同梱されています。

• 特定のバグは、使用されている GStreamer のバージョンに起因している可能性があります。お使いのプラットフォームで最新のGStreamerバグフィックスリリースを使用することをお勧めします。
• バグによっては、PulseaudioのようなGStreamerが使用するライブラリに関連している可能性もあります。特にPulseaudio v16には、GStreamerパイプラインをハングアップさせる既知のバグがあり、これら2つのパッチのバックポートが必要です：
  • https://gitlab.freedesktop.org/pulseaudio/pulseaudio/-/merge_requests/745
  • https://gitlab.freedesktop.org/pulseaudio/pulseaudio/-/merge_requests/764

  このバグは現在、Ubuntu 22.04、23.10、24.04、Debian 11、12、Fedora 39、40を含むほとんどの主流Linuxディストリビューションに影響を及ぼしている。

• シーク、再生レート、ループ、シンクの切り替えに既知のバグがあります。

カスタマイズポイント

Qt Multimedia は、基盤となる 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 pipeline decription から 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);

アーキテクチャ上の考慮点

Qt Multimedia は汎用的なストリーミングフレームワークではないため、Qt で GStreamer を使用するアーキテクチャ的に最良の方法とは限りません。GStreamer のパイプラインを高度に制御する必要があるが、Qt でのビデオ出力のみを行いたい開発者は、GStreamer のqml6glsink の使用を検討するとよいでしょう。