QScreenCapture Class

상세 설명

이 클래스는 화면을 캡처합니다. 이 클래스는 ` QMediaCaptureSession ` 클래스에 의해 관리되며, 캡처된 화면은 비디오 미리보기 객체에 표시되거나 파일로 기록될 수 있습니다.

다음 코드 예제는 기본 화면을 캡처하고 그 결과를 QVideoWidget 에 표시하는 방법을 보여줍니다:

QMediaCaptureSession session;
QScreenCapture screenCapture;
session.setScreenCapture(&screenCapture);

QVideoWidget videoWidget;
session.setVideoOutput(&videoWidget);
videoWidget.show();

// With no screen set, the primary screen is captured once capturing starts.
screenCapture.start();

화면 캡처 제한 사항

Qt 6.5.2 이상 버전에서는 QScreenCapture 사용 시 다음과 같은 제한 사항이 적용됩니다:

• FFmpeg 백엔드에서만 지원됩니다.
• 일부 플랫폼에서는 캡처된 화면 내용이 변경되지 않는 동안 새로운 비디오 프레임이 출력되지 않습니다. 따라서 애플리케이션은 요청된 프레임 속도로 프레임이 지속적으로 전송될 것이라고 가정해서는 안 됩니다.
• Wayland 컴포지터를 사용하는 Linux 시스템에서 화면 캡처 구현은 실험적 단계이며 다음과 같은 제한 사항이 있습니다. Wayland 프로토콜의 제한으로 인해 QScreenCapture 클래스의 API를 통해 대상 화면을 설정하거나 가져올 수 없습니다. 대신, ` QScreenCapture::setActive(true)`를 호출하면 OS에서 화면 선택 마법사를 표시합니다. 화면 캡처 기능을 사용하려면 XDG Desktop Portal 및 PipeWire (0.3)를 통해 지원되는 ScreenCast 서비스가 설치되어 있어야 합니다. 이러한 제한 사항은 향후 변경될 수 있습니다.
• Android를 제외한 모바일 운영 체제에서는 지원되지 않습니다. Android에서 화면 캡처를 사용하려면 AndroidManifest.xml 파일에 추가적인 Android 포그라운드 서비스 권한을 추가해야 합니다:

  <manifest ...>
  <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
  <uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PROJECTION" />
  <application ...>
      <service android:name="org.qtproject.qt.android.multimedia.QtScreenCaptureService"
          android:foregroundServiceType="mediaProjection"
          android:exported="false"/>
      </service>
  </application>
  </manifest>

• EGLFS가 탑재된 임베디드 환경에서는 기능이 제한됩니다. Qt Quick 애플리케이션의 경우, 해당 클래스는 현재 QQuickWindow::grabWindow 를 통해 구현되어 있어 성능 문제가 발생할 수 있습니다.
• 대부분의 경우, 화면 캡처 프레임 속도를 화면 재생 빈도와 동일하게 설정하지만, Windows의 경우 프레임 속도가 유연하게 조정될 수 있습니다. 이러한 프레임 속도(75/120 FPS)는 캡처되는 화면의 해상도가 4K인 경우 성능이 낮은 CPU에서 성능 문제를 일으킬 수 있습니다. EGLFS에서는 캡처 프레임 속도가 현재 30 FPS로 고정되어 있습니다.