QMediaCaptureSession Class

QMediaCaptureSessionクラスは、オーディオとビデオコンテンツのキャプチャを可能にします。詳細...

ヘッダー #include <QMediaCaptureSession>
CMake: find_package(Qt6 REQUIRED COMPONENTS Multimedia)
target_link_libraries(mytarget PRIVATE Qt6::Multimedia)
qmake QT += multimedia
QML で CaptureSession
継承: QObject

プロパティ

パブリック機能

QMediaCaptureSession(QObject *parent = nullptr)
virtual ~QMediaCaptureSession() override
QAudioBufferInput *audioBufferInput() const
QAudioInput *audioInput() const
QAudioOutput *audioOutput() const
QCamera *camera() const
QImageCapture *imageCapture()
QMediaRecorder *recorder()
QScreenCapture *screenCapture()
void setAudioBufferInput(QAudioBufferInput *input)
void setAudioInput(QAudioInput *input)
void setAudioOutput(QAudioOutput *output)
void setCamera(QCamera *camera)
void setImageCapture(QImageCapture *imageCapture)
void setRecorder(QMediaRecorder *recorder)
void setScreenCapture(QScreenCapture *screenCapture)
void setVideoFrameInput(QVideoFrameInput *input)
void setVideoOutput(QObject *output)
void setVideoSink(QVideoSink *sink)
void setWindowCapture(QWindowCapture *windowCapture)
QVideoFrameInput *videoFrameInput() const
QObject *videoOutput() const
QVideoSink *videoSink() const
QWindowCapture *windowCapture()

シグナル

詳細説明

QMediaCaptureSessionは、ローカルデバイス上のメディアのキャプチャを管理する中心的なクラスです。

setCamera ()、setScreenCapture ()、setWindowCapture ()またはsetVideoFrameInput ()を使用して、QMediaCaptureSessionにビデオ入力を接続できます。setVideoOutput() を使用してQVideoWidget またはQGraphicsVideoItem を設定すると、キャプチャしたメディアのプレビューを見ることができます。

QMediaCaptureSession には、setAudioInput() を使用してマイクを接続するか、setAudioBufferInput() を使用してカスタムの音声入力を設定できます。キャプチャした音声は、setAudioOutput ()を使用して出力デバイスにルーティングすることで聞くことができます。

キャプチャセッションにQImageCapture オブジェクトを設定することで、カメラから静止画をキャプチャし、QMediaRecorder を使用して音声/動画を記録することができます。

QCamera,QAudioDevice,QMediaRecorder,QImageCapture,QScreenCapture,QWindowCapture,QVideoFrameInput,QMediaRecorder,QGraphicsVideoItemも参照

プロパティ・ドキュメンテーション

[since 6.8] audioBufferInput : QAudioBufferInput*

このプロパティは、カスタムオーディオバッファをQMediaRecorder に送信するために使用されるオブジェクトを保持します。

このプロパティは Qt 6.8 で導入されました。

アクセス関数

QAudioBufferInput *audioBufferInput() const
void setAudioBufferInput(QAudioBufferInput *input)

Notifierシグナル:

void audioBufferInputChanged()

audioInput : QAudioInput*

オーディオキャプチャに使用されているデバイスを返します。

アクセス関数

QAudioInput *audioInput() const
void setAudioInput(QAudioInput *input)

Notifierシグナル

void audioInputChanged()

audioOutput : QAudioOutput*

セッションのオーディオ出力を返します。

アクセス関数

QAudioOutput *audioOutput() const
void setAudioOutput(QAudioOutput *output)

通知シグナル

void audioOutputChanged()

camera : QCamera*

このプロパティは、ビデオのキャプチャに使用するカメラを保持します。

このプロパティを使用してキャプチャセッションにカメラを追加することで、ビデオの録画や画像の撮影を行います。

アクセス関数

QCamera *camera() const
void setCamera(QCamera *camera)

通知シグナル

void cameraChanged()

imageCapture : QImageCapture*

静止画キャプチャに使用するオブジェクトを保持する。

キャプチャセッションにQImageCapture オブジェクトを追加することで、カメラからの静止画キャプチャが可能になります。

アクセス関数

QImageCapture *imageCapture()
void setImageCapture(QImageCapture *imageCapture)

通知シグナル

void imageCaptureChanged()

recorder : QMediaRecorder*

このプロパティは、オーディオ/ビデオをキャプチャするために使用されるレコーダーオブジェクトを保持します。

QMediaRecorder オブジェクトをキャプチャセッションに追加すると、キャプチャセッションからオーディオおよび/またはビデオを録画できるようになります。

アクセス関数

QMediaRecorder *recorder()
void setRecorder(QMediaRecorder *recorder)

通知シグナル

void recorderChanged()

[since 6.5] screenCapture : QScreenCapture*

このプロパティは、画面のキャプチャに使用するオブジェクトを保持する。

このプロパティを使用してキャプチャセッションにスクリーンキャプチャオブジェクトを追加することで、画面を記録します。

このプロパティはQt 6.5で導入されました。

アクセス関数です:

QScreenCapture *screenCapture()
void setScreenCapture(QScreenCapture *screenCapture)

Notifierシグナル

void screenCaptureChanged()

[since 6.8] videoFrameInput : QVideoFrameInput*

このプロパティは、カスタムビデオフレームをQMediaRecorder またはビデオ出力に送信するために使用されるオブジェクトを保持します。

このプロパティは Qt 6.8 で導入されました。

アクセス関数です:

QVideoFrameInput *videoFrameInput() const
void setVideoFrameInput(QVideoFrameInput *input)

Notifier シグナル:

void videoFrameInputChanged()

videoOutput : QObject*

セッションのビデオ出力を返します。

アクセス関数

QObject *videoOutput() const
void setVideoOutput(QObject *output)

通知シグナル

void videoOutputChanged()

[since 6.6] windowCapture : QWindowCapture*

このプロパティはウィンドウのキャプチャに使用されるオブジェクトを保持する。

このプロパティを使ってキャプチャセッションにウィンドウキャプチャオブジェクトを追加することで、ウィンドウを記録します。

このプロパティはQt 6.6で導入されました。

アクセス関数です:

QWindowCapture *windowCapture()
void setWindowCapture(QWindowCapture *windowCapture)

Notifierシグナル

void windowCaptureChanged()

メンバ関数ドキュメント

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

parent オブジェクトからメディアキャプチャ用のセッションを作成します。

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

セッションを破棄する。

void QMediaCaptureSession::setAudioInput(QAudioInput *input)

オーディオ入力デバイスをinput に設定します。空のQAudioDevice に設定すると、キャプチャセッションはオペレーティングシステムによって定義されたデフォルトの入力を使用します。

注: プロパティaudioInput のセッター関数です。

audioInput()も参照してください

void QMediaCaptureSession::setAudioOutput(QAudioOutput *output)

オーディオ出力デバイスをoutput に設定します。

オーディオ出力デバイスを設定すると、オーディオ入力デバイスからのオーディオルーティングが可能になります。

注: プロパティaudioOutput のセッター関数。

audioOutput()も参照してください

void QMediaCaptureSession::setVideoOutput(QObject *output)

キャプチャセッションのビデオプレビューにQObject 、(output) を設定する。

QObject ベースのプレビューは、QVideoSink を返す呼び出し可能なvideoSink() メソッドを持つことが期待される。

以前に設定されたプレビューは切り離される。

注: プロパティvideoOutput に対するセッター関数。

videoOutput()も参照

void QMediaCaptureSession::setVideoSink(QVideoSink *sink)

キャプチャセッションのビデオプレビューにQVideoSink 、(sink) を設定する。

QObject ベースのプレビューは、QVideoSink を返す呼び出し可能なvideoSink() メソッドを持つことが期待される。

以前に設定されたプレビューは切り離される。

videoSink()も参照

QVideoSink *QMediaCaptureSession::videoSink() const

セッションのQVideoSink を返す。

setVideoSink()も参照

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.