Sur cette page

CaptureSession QML Type

Permet la capture de contenu audio et vidéo. En savoir plus...

Import Statement: import QtMultimedia
In C++: QMediaCaptureSession

Propriétés

Signaux

Description détaillée

Il s'agit du type central qui gère la capture de contenus multimédias sur l'appareil local.

Connectez une caméra et un microphone à une instance de CaptureSession en attribuant des objets Camera et AudioInput aux propriétés correspondantes.

Capturez un écran en connectant un objet ` ScreenCapture ` à la propriété ` screenCapture `.

Capturez une fenêtre en connectant un objet « WindowCapture » à la propriété « windowCapture ».

Activez l’aperçu du média capturé en attribuant un élément « VideoOutput » à la propriété « videoOutput ».

Acheminez le son vers un périphérique de sortie en attribuant un objet ` AudioOutput ` à la propriété ` audioOutput `.

Capturez des images fixes à partir d’une caméra en attribuant un objet ` ImageCapture ` à la propriété ` imageCapture `.

Enregistrez de l'audio/vidéo en attribuant un objet ` MediaRecorder ` à la propriété `recorder`.

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

    recorder: MediaRecorder {
        id: recorder
    }
    videoOutput: preview

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

Remarque : pour vous assurer que la caméra commence à capturer des images vidéo sur toutes les plateformes, appelez explicitement `camera.start()`, généralement dans le gestionnaire `Component.onCompleted`.

Voir également Camera, MediaDevices, MediaRecorder, ImageCapture, ScreenCapture, WindowCapture, GStreamerVideoSource, AudioInput et VideoOutput.

Documentation relative aux biens immobiliers

audioInput : AudioInput

Cette propriété contient l'entrée audio utilisée pour l'enregistrement.

audioOutput : AudioOutput

Le périphérique de sortie audio pour la session de capture.

Ajoutez un périphérique « AudioOutput » à la session de capture pour activer l'acheminement audio depuis un périphérique « AudioInput ».

camera : Camera

La caméra utilisée pour enregistrer la vidéo.

Enregistrez une vidéo ou prenez des photos en ajoutant une caméra à la session de capture à l'aide de cette propriété.

imageCapture : ImageCapture

Objet utilisé pour capturer des images fixes.

Ajoutez une interface ` ImageCapture ` à la session de capture pour permettre la capture d'images fixes à partir de l'appareil photo.

nativeVideoSource : GStreamerVideoSource [since 6.12]

Source vidéo native utilisée pour la capture vidéo.

Pour l'instant, il n'est possible de définir que GStreamerVideoSource comme source vidéo native. Une session de capture ne peut avoir à la fois Camera et GStreamerVideoSource définis.

Cette propriété a été introduite dans Qt 6.12.

Voir également GStreamerVideoSource et Camera.

recorder : MediaRecorder

Objet d'enregistrement utilisé pour capturer du contenu audio/vidéo.

Ajoutez un objet MediaRecorder à la session de capture pour permettre l'enregistrement audio et/ou vidéo à partir de cette session.

screenCapture : ScreenCapture [since 6.5]

Objet utilisé pour effectuer une capture d'écran.

Enregistrez un écran en ajoutant un objet de capture d'écran à la session de capture à l'aide de cette propriété.

Cette propriété a été introduite dans Qt 6.5.

videoOutput : VideoOutput

L'VideoOutput, qui correspond à l'aperçu vidéo de la session de capture.

Un aperçu basé sur un ` VideoOutput ` doit disposer d'une méthode `videoSink()` appelable qui renvoie un ` QVideoSink`.

L'aperçu précédemment défini est détaché.

windowCapture : WindowCapture [since 6.6]

Objet utilisé pour capturer une fenêtre.

Enregistrez une fenêtre en ajoutant un objet de capture de fenêtre à la session de capture à l'aide de cette propriété.

Cette propriété a été introduite dans Qt 6.6.

Documentation sur les signaux

audioInputChanged()

Ce signal est émis lorsqu'une entrée audio a changé.

Remarque : le gestionnaire correspondant est onAudioInputChanged.

Voir également CaptureSession::audioInput.

audioOutputChanged()

Ce signal est émis lorsque la sortie audio sélectionnée a changé.

Remarque : le gestionnaire correspondant est onAudioOutputChanged.

Voir également CaptureSession::audioOutput.

cameraChanged()

Ce signal est émis lorsque la caméra sélectionnée a changé.

Remarque : le gestionnaire correspondant est onCameraChanged.

Voir également CaptureSession::camera.

imageCaptureChanged()

Ce signal est émis lorsque l'interface sélectionnée a changé.

Remarque : le gestionnaire correspondant est onImageCaptureChanged.

Voir également CaptureSession::camera.

nativeVideoSourceChanged()

Ce signal est émis lorsque la source vidéo native sélectionnée a changé.

Remarque : le gestionnaire correspondant est onNativeVideoSourceChanged.

Voir également CaptureSession::nativeVideoSource.

recorderChanged()

Ce signal est émis lorsque l'enregistreur sélectionné a changé.

Remarque : le gestionnaire correspondant est onRecorderChanged.

Voir également CaptureSession::recorder.

videoOutputChanged()

Ce signal est émis lorsque la sortie vidéo sélectionnée a changé.

Remarque : le gestionnaire correspondant est onVideoOutputChanged.

Voir également 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.