CaptureSession QML Type
오디오 및 비디오 콘텐츠를 캡처할 수 있습니다. 더 보기...
| Import Statement: | import QtMultimedia |
| In C++: | QMediaCaptureSession |
속성
- 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)
신호
- audioInputChanged()
- audioOutputChanged()
- cameraChanged()
- imageCaptureChanged()
- nativeVideoSourceChanged()
- recorderChanged()
- videoOutputChanged()
상세 설명
이 클래스는 로컬 장치에서 미디어 캡처를 관리하는 핵심 클래스입니다.
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.