このページでは

CaptureSession QML Type

オーディオおよびビデオコンテンツのキャプチャが可能です。詳細...

Import Statement: import QtMultimedia
In C++: QMediaCaptureSession

プロパティ

信号

詳細説明

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

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

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

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

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

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

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

recorder プロパティにMediaRecorder を割り当てて、オーディオ/ビデオを録画します。

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() を明示的に呼び出します。

CameraMediaDevicesMediaRecorderImageCaptureScreenCaptureWindowCaptureAudioInputVideoOutputも参照

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

audioInput : AudioInput

このプロパティは、オーディオをキャプチャするために使用されているオーディオ入力を保持します。

audioOutput : AudioOutput

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

AudioInput デバイスからのオーディオルーティングを有効にするには、キャプチャセッションにAudioOutput デバイスを追加します。

camera : Camera

ビデオのキャプチャに使用するカメラ。

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

imageCapture : ImageCapture

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

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

recorder : MediaRecorder

オーディオ/ビデオをキャプチャするために使用されるレコーダーオブジェクト。

MediaRcorderオブジェクトをキャプチャセッションに追加することで、キャプチャセッションからオーディオやビデオを記録できるようになります。

screenCapture : ScreenCapture [since 6.5]

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

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

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

videoOutput : VideoOutput

キャプチャセッションのビデオプレビューであるVideoOutput

VideoOutput ベースのプレビューは、QVideoSink を返す invokable 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も参照のこと

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.