CaptureSession QML Type
Ermöglicht die Aufnahme von Audio- und Videoinhalten. Mehr...
| Import Statement: | import QtMultimedia |
| In C++: | QMediaCaptureSession |
Eigenschaften
- audioInput : AudioInput
- audioOutput : AudioOutput
- camera : Camera
- imageCapture : ImageCapture
- nativeVideoSource : GStreamerVideoSource
(since 6.12) - recorder : MediaRecorder
- screenCapture : ScreenCapture
(since 6.5) - videoOutput : VideoOutput
- windowCapture : WindowCapture
(since 6.6)
Signale
- audioInputChanged()
- audioOutputChanged()
- cameraChanged()
- imageCaptureChanged()
- nativeVideoSourceChanged()
- recorderChanged()
- videoOutputChanged()
Ausführliche Beschreibung
Dies ist der zentrale Typ, der die Erfassung von Medien auf dem lokalen Gerät verwaltet.
Schließen Sie eine Kamera und ein Mikrofon an eine „CaptureSession“ an, indem Sie den entsprechenden Eigenschaften Objekte vom Typ „Camera“ und „ AudioInput “ 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 erfassten Medien, indem Sie der Eigenschaft „ videoOutput “ ein „ VideoOutput “-Element 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 “-Objekt zuweisen.
Nehmen Sie Audio/Video auf, indem Sie der Eigenschaft „recorder“ ein „ MediaRecorder “-Objekt 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, in der Regel im Handler `Component.onCompleted`.
Siehe auch „ Camera“ , „ MediaDevices “, „ MediaRecorder “, „ ImageCapture “, „ ScreenCapture “, „ WindowCapture “, „ GStreamerVideoSource “, „ AudioInput “ und „ VideoOutput “.
Dokumentation zu Eigenschaften
audioInput : AudioInput
Diese Eigenschaft enthält den Audioeingang, der zur Audioaufnahme verwendet wird.
audioOutput : AudioOutput
Das Audioausgabegerät für die Aufnahmesitzung.
Fügen Sie der Aufnahmesitzung ein „ AudioOutput “-Gerät hinzu, um die Audioweiterleitung von einem „ AudioInput “-Gerät zu ermöglichen.
camera : Camera
Die Kamera, die zur Videoaufnahme verwendet wird.
Nehmen Sie Videos auf oder machen Sie Fotos, indem Sie mithilfe dieser Eigenschaft eine Kamera zur Aufnahmesitzung hinzufügen.
imageCapture : ImageCapture
Das Objekt, das zur Aufnahme von Standbildern verwendet wird.
Fügen Sie der Aufnahmesitzung eine „ ImageCapture “-Schnittstelle hinzu, um die Aufnahme von Standbildern mit der Kamera zu ermöglichen.
nativeVideoSource : GStreamerVideoSource [since 6.12]
Die native Videoquelle, die zur Videoaufnahme verwendet wird.
Derzeit ist es nur möglich, „ GStreamerVideoSource “ als native Videoquelle festzulegen. In einer Aufnahmesitzung kann jeweils entweder „ Camera “ oder „ GStreamerVideoSource “ festgelegt werden.
Diese Eigenschaft wurde in Qt 6.12 eingeführt.
Siehe auch „ GStreamerVideoSource “ und „ Camera “.
recorder : MediaRecorder
Das Recorder-Objekt, das zur Aufzeichnung von Audio- und Videodaten verwendet wird.
Fügen Sie der Aufnahmesitzung ein MediaRecorder-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 Bildschirmaufnahme verwendet wird.
Nehmen Sie einen Bildschirm auf, indem Sie mithilfe dieser Eigenschaft ein Bildschirmaufnahmeobjekt zur Aufnahmesitzung hinzufügen.
Diese Eigenschaft wurde in Qt 6.5 eingeführt.
videoOutput : VideoOutput
Das ` VideoOutput `, das die Videovorschau für die Aufnahmesitzung darstellt.
Eine auf dem „ VideoOutput “ basierende Vorschau verfügt erwartungsgemäß über eine aufrufbare „videoSink()“-Methode, die ein „ QVideoSink “ zurückgibt.
Die zuvor festgelegte Vorschau wird getrennt.
windowCapture : WindowCapture [since 6.6]
Das Objekt, das zum Erfassen eines Fensters verwendet wird.
Um ein Fenster aufzuzeichnen, fügen Sie mithilfe dieser Eigenschaft ein Fenster-Aufnahmeobjekt zur Aufnahmesitzung hinzu.
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 lautet „ onAudioInputChanged “.
Siehe auch CaptureSession::audioInput.
audioOutputChanged()
Dieses Signal wird ausgegeben, wenn sich der ausgewählte Audioausgang geändert hat.
Hinweis: Der entsprechende Handler lautet „ onAudioOutputChanged “.
Siehe auch CaptureSession::audioOutput.
cameraChanged()
Dieses Signal wird ausgegeben, wenn sich die ausgewählte Kamera geändert hat.
Hinweis: Der entsprechende Handler lautet onCameraChanged.
Siehe auch CaptureSession::camera.
imageCaptureChanged()
Dieses Signal wird ausgelöst, wenn sich die ausgewählte Schnittstelle geändert hat.
Hinweis: Der entsprechende Handler lautet „ onImageCaptureChanged “.
Siehe auch CaptureSession::camera.
nativeVideoSourceChanged()
Dieses Signal wird ausgegeben, wenn sich die ausgewählte native Videoquelle geändert hat.
Hinweis: Der entsprechende Handler lautet „ onNativeVideoSourceChanged “.
Siehe auch CaptureSession::nativeVideoSource.
recorderChanged()
Dieses Signal wird ausgegeben, wenn sich der ausgewählte Rekorder geändert hat.
Hinweis: Der entsprechende Handler lautet „ onRecorderChanged “.
Siehe auch CaptureSession::recorder.
videoOutputChanged()
Dieses Signal wird ausgegeben, wenn sich der ausgewählte Videoausgang geändert hat.
Hinweis: Der entsprechende Handler lautet „ 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.