QScreenCapture Class

Ausführliche Beschreibung

Die Klasse erfasst einen Bildschirm. Sie wird von der Klasse „ QMediaCaptureSession “ verwaltet, wo der erfasste Bildschirm in einem Video-Vorschau-Objekt angezeigt oder in einer Datei aufgezeichnet werden kann.

Der folgende Codeausschnitt zeigt, wie der primäre Bildschirm erfasst und das Ergebnis in einem „ QVideoWidget “ angezeigt wird:

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();

Einschränkungen bei der Bildschirmaufnahme

Ab Qt 6.5.2 gelten für die Verwendung von `QScreenCapture` die folgenden Einschränkungen:

• Die Funktion wird nur mit dem FFmpeg-Backend unterstützt.
• Auf einigen Plattformen werden keine neuen Videobilder ausgegeben, während der aufgenommene Bildschirminhalt unverändert bleibt. Anwendungen sollten sich daher nicht darauf verlassen, einen kontinuierlichen Strom von Bildern mit der angeforderten Bildrate zu erhalten.
• Auf Linux-Systemen, die den Wayland-Compositor verwenden, ist die Bildschirmaufnahme-Implementierung experimentell und unterliegt den folgenden Einschränkungen. Aufgrund von Einschränkungen des Wayland-Protokolls ist es nicht möglich, den Zielbildschirm über die API der Klasse ` QScreenCapture ` festzulegen und abzurufen. Stattdessen zeigt das Betriebssystem beim Aufruf von ` QScreenCapture::setActive(true)` einen Assistenten zur Bildschirmauswahl an. Die Bildschirmaufnahmefunktion erfordert die Installation des ScreenCast-Dienstes, der über das XDG Desktop Portal und PipeWire (0.3) unterstützt wird. Diese Einschränkungen können sich in Zukunft ändern.
• Auf mobilen Betriebssystemen wird diese Funktion nicht unterstützt, mit Ausnahme von Android. Für die Bildschirmaufnahme unter Android muss der Datei „ AndroidManifest.xml “ eine zusätzliche Berechtigung für den Android-Vordergrunddienst hinzugefügt werden:

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

• Auf Embedded-Systemen mit EGLFS ist die Funktionalität eingeschränkt. Für Qt Quick -Anwendungen wird die Klasse derzeit über QQuickWindow::grabWindow implementiert, was zu Leistungsproblemen führen kann.
• In den meisten Fällen legen wir eine Bildrate für die Bildschirmaufnahme fest, die der Bildwiederholfrequenz des Bildschirms entspricht, außer unter Windows, wo die Bildrate flexibel sein kann. Eine solche Bildrate (75/120 FPS) kann auf schwachen CPUs zu Leistungsproblemen führen, wenn der aufgenommene Bildschirm eine 4K-Auflösung hat. Bei EGLFS ist die Bildaufnahmerate derzeit auf 30 FPS festgelegt.