이 페이지에서

WindowCapture QML Type

이 유형은 창을 캡처하는 데 사용됩니다. 더 보기...

Import Statement: import QtMultimedia
Since: Qt 6.6
In C++: QWindowCapture

속성

방법

자세한 설명

WindowCapture는 창을 캡처합니다. 캡처된 창을 비디오 미리보기 객체에 표시하거나 파일에 녹화할 수 있는 MediaCaptureSession에서 관리합니다.

창 캡처 제한 사항

WindowCapture 사용에는 다음과 같은 제한 사항이 적용됩니다:

  • WindowCapture는 FFmpeg 백엔드에서만 지원됩니다.

X11 시스템에서 QWindowCapture 을 사용하는 경우 다음 제한 사항이 적용됩니다:

  • Linux X11 시스템에서 창이 보이는 화면 영역 밖으로 부분적으로 이동하면 보이는 영역만 캡처됩니다. 따라서 방출되는 비디오 프레임의 크기가 창의 지오메트리보다 작을 수 있습니다.
  • 보이는 화면 영역 밖에 있는 창은 캡처할 수 없으며, 이 경우 오류 신호가 발생합니다.
  • 최소화 창 또는 보이지 않는 가상 작업 공간에 있는 창은 창 관리자에 따라 동작이 달라집니다. 예를 들어, GNOME에서는 이러한 창을 캡처할 수 있지만 WindowMaker 또는 Xfwm에서는 이러한 캡처가 허용되지 않으며 창 캡처 인스턴스에서 오류를 발생시킵니다.

CaptureSessionCapturableWindow참조하세요 .

속성 문서

active : bool

캡처가 현재 활성화되어 있는지 여부를 설명합니다.

error : enumeration [read-only]

마지막 오류의 코드를 반환합니다.

errorString : string [read-only]

오류의 원인을 설명하는 사람이 읽을 수 있는 문자열을 반환합니다.

window : Window

캡처 창에 대해 설명합니다.

QtMultimedia::WindowCapture::capturableWindows도 참조하세요 .

메서드 문서

list<CapturableWindow> capturableWindows()

캡처할 수 있는 CapturableWindow 객체 목록을 반환합니다.

void start()

window 캡처를 시작합니다.

이는 active 속성을 true 으로 설정하는 것과 동일합니다.

void stop()

캡처를 중지합니다.

이는 active 속성을 false 으로 설정하는 것과 동일합니다.

© 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.