このページでは

CaptureSession QML Type

音声および動画コンテンツのキャプチャが可能です。詳細...

Import Statement: import QtMultimedia
In C++: QMediaCaptureSession

プロパティ

信号

詳細な説明

これは、ローカルデバイス上でのメディアのキャプチャを管理する中心となる型です。

Camera オブジェクトおよびAudioInput オブジェクトをそれぞれのプロパティに割り当てることで、カメラとマイクを CaptureSession に接続します。

ScreenCapture オブジェクトをscreenCapture プロパティに接続して、画面をキャプチャします。

WindowCapture オブジェクトをwindowCapture プロパティに接続して、ウィンドウをキャプチャします。

VideoOutput 要素をvideoOutput プロパティに割り当てることで、キャプチャしたメディアのプレビューを有効にします。

AudioOutput オブジェクトをaudioOutput プロパティに割り当てることで、オーディオを出力デバイスにルーティングします。

`imageCapture ` プロパティに `ImageCapture ` を割り当てることで、カメラから静止画像をキャプチャします。

MediaRecorder を recorder プロパティに割り当てることで、音声や動画を録画します。

CaptureSession {
    id: captureSession
    camera: Camera {
        id: camera
    }
    imageCapture: ImageCapture {
        id: imageCapture
    }

    recorder: MediaRecorder {
        id: recorder
    }
    videoOutput: preview

    Component.onCompleted: {
        camera.start()
    }
}

注: すべてのプラットフォームでカメラが動画フレームのキャプチャを開始するようにするには 、通常は Component.onCompleted ハンドラ内で、明示的に camera.start() を呼び出してください。

関連項目: Camera 、MediaDevices 、MediaRecorder 、ImageCapture 、ScreenCapture 、WindowCapture 、GStreamerVideoSource 、AudioInput 、およびVideoOutput 。

プロパティのドキュメント

audioInput : AudioInput

このプロパティには、オーディオのキャプチャに使用されているオーディオ入力が格納されます。

audioOutput : AudioOutput

キャプチャセッション用のオーディオ出力デバイス。

キャプチャセッションに「AudioOutput 」デバイスを追加すると、AudioInput デバイスからのオーディオルーティングが可能になります。

camera : Camera

動画の撮影に使用するカメラ。

このプロパティを使用して、キャプチャセッションにカメラを追加し、動画を録画したり画像を撮影したりします。

imageCapture : ImageCapture

静止画の撮影に使用するオブジェクト。

キャプチャセッションにImageCapture インターフェースを追加することで、カメラからの静止画のキャプチャが可能になります。

nativeVideoSource : GStreamerVideoSource [since 6.12]

動画のキャプチャに使用されるネイティブ動画ソース。

現時点では、ネイティブ動画ソースとしてGStreamerVideoSource のみを設定可能です。キャプチャセッションでは、Camera とGStreamerVideoSource のいずれか一方のみを設定できます。

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

「 GStreamerVideoSource 」および「Camera 」も参照してください 。

recorder : MediaRecorder

オーディオやビデオのキャプチャに使用されるレコーダーオブジェクト。

キャプチャセッションにMediaRecorderオブジェクトを追加することで、そのキャプチャセッションからの音声および/または動画の録画が可能になります。

screenCapture : ScreenCapture [since 6.5]

画面のキャプチャに使用されるオブジェクト。

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

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

videoOutput : VideoOutput

キャプチャセッションの動画プレビューとなるVideoOutput 。

VideoOutput に基づくプレビューには、QVideoSink を返す、呼び出し可能な videoSink() メソッドが備わっていることが期待されます。

以前に設定されていたプレビューは切り離されます。

windowCapture : WindowCapture [since 6.6]

ウィンドウのキャプチャに使用されるオブジェクト。

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

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

シグナルのドキュメント

audioInputChanged()

このシグナルは、オーディオ入力が変更されたときに発せられます。

注: 対応するハンドラは onAudioInputChanged です。

「CaptureSession::audioInput」も参照してください 。

audioOutputChanged()

このシグナルは、選択されているオーディオ出力が変更されたときに発信されます。

注: 対応するハンドラは `onAudioOutputChanged` です。

「CaptureSession::audioOutput」も参照してください 。

cameraChanged()

このシグナルは、選択されているカメラが変更されたときに発信されます。

注: 対応するハンドラは onCameraChanged です。

CaptureSession::cameraも参照してください 。

imageCaptureChanged()

このシグナルは、選択されたインターフェースが変更されたときに発信されます。

注: 対応するハンドラは `onImageCaptureChanged` です。

「CaptureSession::camera」も参照してください 。

nativeVideoSourceChanged()

このシグナルは、選択されたネイティブビデオソースが変更されたときに発行されます。

注: 対応するハンドラは onNativeVideoSourceChanged です。

「CaptureSession::nativeVideoSource」も参照してください 。

recorderChanged()

このシグナルは、選択されているレコーダーが変更されたときに発信されます。

注: 対応するハンドラは onRecorderChanged です。

「CaptureSession::recorder」も参照してください 。

videoOutputChanged()

このシグナルは、選択されたビデオ出力が変更されたときに発信されます。

注: 対応するハンドラは onVideoOutputChanged です。

「CaptureSession::videoOutput」も参照してください 。

© 2026 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.