QGStreamerInterface Class

メンバ関数のドキュメント

[virtual noexcept] QGStreamerInterface::~QGStreamerInterface()

インターフェースを破棄します。

[pure virtual] QVideoFrame QGStreamerInterface::createFrameFromGstBuffer(GstBuffer *buffer, const GstVideoInfo &videoInfo)

videoInfo で説明されている形式に従って、buffer をラップするQVideoFrame を作成します。

作成されたフレームは、指定された `GstBuffer ` の所有権を呼び出し元と共有します。

createFrameFromGstBuffer(GstBuffer *, const GstVideoInfoDmaDrm &) およびgstBuffer()も参照してください 。

[pure virtual] QVideoFrame QGStreamerInterface::createFrameFromGstBuffer(GstBuffer *buffer, const GstVideoInfoDmaDrm &videoInfo)

videoInfo で定義されている形式に従い、DMA-BUF をバックエンドとする `buffer ` をラップする `QVideoFrame ` を作成します。

DMA-BUF ビデオフォーマットをサポートする GStreamer 1.24 以降が必要です。サポートされていない場合、無効な `QVideoFrame ` を返し、警告をログに記録します。

作成されたフレームは、指定されたGstBuffer の所有権を呼び出し元と共有します。

createFrameFromGstBuffer(GstBuffer *, const GstVideoInfo &) およびgstBuffer()も参照してください 。

[pure virtual] GstBuffer *QGStreamerInterface::gstBuffer(const QVideoFrame &frame)

frame を裏付けとする GStreamer バッファを返します。frame が GStreamer を裏付けとするビデオメモリを保持していない場合は、nullptr を返します。

返されるバッファの所有権は譲渡されません。

createFrameFromGstBuffer()も参照してください 。

[pure virtual] GstPipeline *QGStreamerInterface::gstPipeline(QMediaCaptureSession *session)

session の基になる GStreamer パイプラインを返します。session が GStreamer メディアバックエンドによってサポートされていない場合は、nullptr を返します。

QMediaCaptureSessionも参照してください 。

[pure virtual] GstPipeline *QGStreamerInterface::gstPipeline(QMediaPlayer *player)

player の基盤となる GStreamer パイプラインを返します。player が GStreamer メディアバックエンドによってサポートされていない場合は、nullptr を返します。

QMediaPlayerも参照してください 。

[static] QGStreamerInterface *QGStreamerInterface::instance()

アクティブなQt Multimedia バックエンドのGStreamerインターフェースを返します。GStreamerバックエンドが使用されていない場合は、nullptr を返します。

[pure virtual] QAudioDevice QGStreamerInterface::makeCustomGStreamerAudioInput(const QByteArray &gstreamerPipeline)

GStreamerパイプライン記述から、カスタムオーディオ入力デバイスを作成します。

gstreamerPipeline という文字列は、GStreamerのbin記述として解析されます。返されたQAudioDevice をQAudioInput に渡して、QMediaCaptureSession::setAudioInput()で割り当てると、その結果として生成された要素がQMediaCaptureSession のオーディオソースとして接続されます。

記述内の要素名は、キャプチャセッションがアクティブになった後、gst_bin_get_by_name() を通じてセッションパイプライン内のノードを特定するために使用できます。

#include <QtMultimedia/spi/qgstreamerinterface.h>

QMediaCaptureSession session;
QAudioInput input{
    QGStreamerInterface::instance()->makeCustomGStreamerAudioInput(
        "audiotestsrc wave=2 freq=200 ! identity name=myConverter") };
session.setAudioInput(&input);

makeCustomGStreamerAudioOutput()、QAudioInput 、およびQMediaCaptureSessionも参照してください 。

[pure virtual] QAudioDevice QGStreamerInterface::makeCustomGStreamerAudioOutput(const QByteArray &gstreamerPipeline)

GStreamerパイプライン記述から、カスタムオーディオ出力デバイスを作成します。

gstreamerPipeline という文字列は、GStreamerのbin記述として解析されます。返されたQAudioDevice をQAudioOutput に渡して、QMediaCaptureSession::setAudioOutput()で割り当てると、その結果として生成された要素はQMediaCaptureSession のオーディオシンクとして接続されます。

makeCustomGStreamerAudioInput()、QAudioOutput 、およびQMediaCaptureSessionも参照してください 。