Back to Qt.io
Contact Us Blog Download Qt
Auf dieser Seite

CaptureSession QML Type

Ermöglicht das Aufnehmen von Audio- und Videoinhalten. Mehr...

Import Statement: import QtMultimedia
In C++: QMediaCaptureSession

Eigenschaften

Signale

Detaillierte Beschreibung

Dies ist der zentrale Typ, der das Aufnehmen von Medien auf dem lokalen Gerät verwaltet.

Verbinden Sie eine Kamera und ein Mikrofon mit einer CaptureSession, indem Sie die Objekte Camera und AudioInput den entsprechenden Eigenschaften zuweisen.

Erfassen Sie einen Bildschirm, indem Sie ein ScreenCapture -Objekt mit der Eigenschaft screenCapture verbinden.

Erfassen Sie ein Fenster, indem Sie ein WindowCapture -Objekt mit der Eigenschaft windowCapture verbinden.

Aktivieren Sie eine Vorschau der aufgenommenen Medien, indem Sie der Eigenschaft videoOutput ein Element VideoOutput zuweisen.

Leiten Sie Audio an ein Ausgabegerät weiter, indem Sie der Eigenschaft audioOutput ein AudioOutput Objekt zuweisen.

Erfassen Sie Standbilder von einer Kamera, indem Sie der Eigenschaft imageCapture ein ImageCapture zuweisen.

Zeichnen Sie Audio/Video auf, indem Sie der Recorder-Eigenschaft ein MediaRecorder zuweisen.

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

    recorder: MediaRecorder {
        id: recorder
    }
    videoOutput: preview

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

Hinweis: Um sicherzustellen, dass die Kamera auf allen Plattformen mit der Aufnahme von Videobildern beginnt, rufen Sie explizit camera.start() auf, normalerweise im Component.onCompleted-Handler.

Siehe auch Camera, MediaDevices, MediaRecorder, ImageCapture, ScreenCapture, WindowCapture, AudioInput, und VideoOutput.

Dokumentation der Eigenschaften

audioInput : AudioInput

Diese Eigenschaft enthält den Audioeingang, der für die Audioaufnahme verwendet wird.

audioOutput : AudioOutput

Das Audio-Ausgabegerät für die Capture-Sitzung.

Fügen Sie der Capture-Sitzung ein AudioOutput Gerät hinzu, um das Audio-Routing von einem AudioInput Gerät zu aktivieren.

camera : Camera

Die für die Videoaufnahme verwendete Kamera.

Nehmen Sie Videos oder Bilder auf, indem Sie mit dieser Eigenschaft eine Kamera zur Aufnahmesitzung hinzufügen.

imageCapture : ImageCapture

Das Objekt, das zur Erfassung von Standbildern verwendet wird.

Fügen Sie der Erfassungssitzung eine Schnittstelle ImageCapture hinzu, um die Erfassung von Standbildern von der Kamera zu ermöglichen.

recorder : MediaRecorder

Das Recorder-Objekt, das zur Aufnahme von Audio/Video verwendet wird.

Fügen Sie der Aufnahmesitzung ein MediaRcorder-Objekt hinzu, um die Aufnahme von Audio und/oder Video aus der Aufnahmesitzung zu ermöglichen.

screenCapture : ScreenCapture [since 6.5]

Das Objekt, das zur Aufnahme eines Bildschirms verwendet wird.

Zeichnen Sie einen Bildschirm auf, indem Sie mit dieser Eigenschaft ein Screen-Capture-Objekt zur Capture-Session hinzufügen.

Diese Eigenschaft wurde in Qt 6.5 eingeführt.

videoOutput : VideoOutput

Die VideoOutput, die die Videovorschau für die Aufnahmesitzung darstellt.

Von einer VideoOutput basierten Vorschau wird erwartet, dass sie eine aufrufbare videoSink()-Methode hat, die ein QVideoSink zurückgibt.

Die zuvor eingestellte Vorschau wird abgetrennt.

windowCapture : WindowCapture [since 6.6]

Das Objekt, das zur Erfassung eines Fensters verwendet wird.

Zeichnen Sie ein Fenster auf, indem Sie mit dieser Eigenschaft ein Fenstererfassungsobjekt zur Erfassungssitzung hinzufügen.

Diese Eigenschaft wurde in Qt 6.6 eingeführt.

Signal Dokumentation

audioInputChanged()

Dieses Signal wird ausgegeben, wenn sich ein Audioeingang geändert hat.

Hinweis: Der entsprechende Handler ist onAudioInputChanged.

Siehe auch CaptureSession::audioInput.

audioOutputChanged()

Dieses Signal wird ausgegeben, wenn sich der ausgewählte Audioausgang geändert hat.

Hinweis: Der entsprechende Handler ist onAudioOutputChanged.

Siehe auch CaptureSession::audioOutput.

cameraChanged()

Dieses Signal wird ausgegeben, wenn sich die ausgewählte Kamera geändert hat.

Hinweis: Der entsprechende Handler ist onCameraChanged.

Siehe auch CaptureSession::camera.

imageCaptureChanged()

Dieses Signal wird ausgegeben, wenn sich die ausgewählte Schnittstelle geändert hat.

Hinweis: Der entsprechende Handler ist onImageCaptureChanged.

Siehe auch CaptureSession::camera.

recorderChanged()

Dieses Signal wird ausgegeben, wenn sich der ausgewählte Schreiber geändert hat.

Hinweis: Der entsprechende Handler ist onRecorderChanged.

Siehe auch CaptureSession::recorder.

videoOutputChanged()

Dieses Signal wird ausgegeben, wenn sich der ausgewählte Videoausgang geändert hat.

Hinweis: Der entsprechende Handler ist onVideoOutputChanged.

Siehe auch 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.