QScreenCapture Class

Descripción Detallada

La clase captura una pantalla. Es manejada por la clase QMediaCaptureSession donde la pantalla capturada puede ser mostrada en un objeto de previsualización de video o grabada en un archivo.

QMediaCaptureSession session;
QAudioInput audioInput;
session.setAudioInput(&input);
QMediaRecorder recorder;
session.setRecorder(&recorder);
recorder.setQuality(QMediaRecorder::HighQuality);
recorder.setOutputLocation(QUrl::fromLocalFile("test.mp3"));
recorder.record();

Limitaciones de la Captura de Pantalla

En Qt 6.5.2 y superiores, las siguientes limitaciones se aplican al uso de QScreenCapture:

• Sólo es compatible con el backend FFmpeg.
• En sistemas Linux usando el compositor Wayland, la implementación de captura de pantalla es experimental y viene con las siguientes limitaciones. Debido a las restricciones del protocolo Wayland, es imposible establecer y obtener la pantalla de destino a través de la API de la clase QScreenCapture. En su lugar, el sistema operativo mostrará un asistente de selección de pantalla al invocar QScreenCapture::setActive(true). La función de captura de pantalla requiere la instalación del servicio ScreenCast soportado a través de XDG Desktop Portal y {https://pipewire.org/}{PipeWire} (0.3). Estas limitaciones podrían cambiar en el futuro.
• No es compatible con sistemas operativos móviles, excepto en Android. Screen Capture en Android necesita un permiso adicional del servicio de primer plano de Android que debe añadirse al archivo AndroidManifest.xml:

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

• En embebidos con EGLFS, su funcionalidad es limitada. Para aplicaciones Qt Quick, la clase se implementa actualmente a través de QQuickWindow::grabWindow, lo que puede causar problemas de rendimiento.
• En la mayoría de los casos, establecemos una tasa de fotogramas de captura de pantalla igual a la tasa de refresco de la pantalla, excepto en Windows, donde la tasa puede ser flexible. Una tasa de fotogramas de este tipo (75/120 FPS) podría causar problemas de rendimiento en CPUs débiles si la pantalla capturada es de resolución 4K. En EGLFS, la tasa de fotogramas de captura está actualmente bloqueada en 30 FPS.