QVideoFrameInput Class

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

[explicit] QVideoFrameInput::QVideoFrameInput(QObject *parent = nullptr)

parent を使用して、新しいQVideoFrameInputオブジェクトを作成します。

[explicit] QVideoFrameInput::QVideoFrameInput(const QVideoFrameFormat &format, QObject *parent = nullptr)

動画フレームformat およびparent を使用して、新しいQVideoFrameInputオブジェクトを構築します。

指定されたformat は、QMediaRecorder::record()を呼び出した際の、対応するビデオエンコーダの初期化におけるヒントとして機能します。フォーマットが指定されていない場合や無効な場合、最初のフレームの送信時にビデオエンコーダが初期化されます。対応するビデオエンコーダの初期化後に、異なるピクセルフォーマットやサイズのビデオフレームを送信すると、録画中のパフォーマンス低下を招く可能性があります。

送信するフレームの種類が事前に分かっている場合は、フォーマットを指定することをお勧めします。

[override virtual noexcept] QVideoFrameInput::~QVideoFrameInput()

そのオブジェクトを破棄します。

QMediaCaptureSession *QVideoFrameInput::captureSession() const

このビデオフレーム入力が接続されているキャプチャセッションを返します。ビデオフレーム入力がキャプチャセッションに接続されていない場合は、nullptr を返します。

QMediaCaptureSession::setVideoFrameInput() を使用して、ビデオフレーム入力をセッションに接続します。

QVideoFrameFormat QVideoFrameInput::format() const

ビデオフレーム入力の生成時に指定されたビデオフレーム形式を返します。

[signal] void QVideoFrameInput::readyToSendVideoFrame()

新しいフレームをビデオフレーム入力に送信できることを示す信号です。この信号を受信した後、送信すべきフレームがある場合は、sendVideoFrame を 1 回、またはループ内で、false が返されるまで呼び出してください。

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

bool QVideoFrameInput::sendVideoFrame(const QVideoFrame &frame)

QVideoFrame をQMediaRecorder に送信するか、QMediaCaptureSession を通じてビデオ出力を送信します。

指定されたframe が宛先に正常に送信された場合、true を返します。 フレームが送信されなかった場合、false を返します。これは、インスタンスがQMediaCaptureSession に割り当てられていない場合、セッションにビデオ出力やメディアレコーダーがない場合、メディアレコーダーが起動されていない場合、またはそのキューが満杯の場合に発生する可能性があります。宛先が新しいフレームを処理できるようになるとすぐに、readyToSendVideoFrame シグナルが送信されます。

空のビデオフレームの送信は、QMediaRecorder によって入力ストリームの終了として扱われます。QMediaRecorder は、QMediaRecorder::autoStop がtrue であり、かつすべての入力がストリームの終了を報告した場合、自動的に録画を停止します。