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)` 时，操作系统会显示一个屏幕选择向导。屏幕捕获功能需要安装由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 系统除外，该系统的帧率可能具有灵活性。如果截图分辨率达到 4K，此类帧率（75/120 FPS）可能会在性能较弱的 CPU 上引发性能问题。 在 EGLFS 上，捕获帧率目前被锁定为 30 FPS。