ScreenCapture QML Type

该类型用于捕捉屏幕。更多

• 所有成员（包括继承成员）的列表

属性

• active : bool
• error : enumeration
• errorString : string
• screen : Screen

详细说明

ScreenCapture 可捕获屏幕。它由 MediaCaptureSession 管理，捕获的屏幕可显示在视频预览对象中或录制到文件中。

下面的代码显示了一个简单的捕获会话，ScreenCapture 会在VideoOutput 中播放捕获的主屏幕视图。

CaptureSession {
    id: captureSession
    screenCapture: ScreenCapture {
        id: screenCapture
        active: true
    }
    videoOutput: VideoOutput {
        id: videoOutput
    }
}

屏幕捕捉限制

在 Qt 6.5.2 及以上版本中，使用 ScreenCapture 有以下限制：

• 仅支持 FFmpeg 后端。
• 在使用 Wayland 合成器的 Linux 系统上，屏幕捕捉的实现是试验性的，有以下限制。由于 Wayland 协议的限制，无法通过QScreenCapture 类的 API 设置和获取目标屏幕。相反，操作系统会在调用QScreenCapture::setActive(true) 时显示屏幕选择向导。屏幕捕捉功能需要安装通过XDG Desktop Portal和 {https://pipewire.org/}{PipeWire} (0.3) 支持的ScreenCast服务。这些限制将来可能会改变。
• 移动操作系统不支持该功能，安卓系统除外。安卓系统上的屏幕捕捉需要在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>

• 在使用 EGLFS 的嵌入式系统上，它的功能有限。对于Qt Quick 应用程序，该类目前是通过QQuickWindow::grabWindow 实现的，这可能会导致性能问题。
• 在大多数情况下，我们设置的屏幕捕获帧频等于屏幕刷新率，但 Windows 系统除外，因为 Windows 系统的刷新率可能比较灵活。如果捕获的屏幕分辨率为 4K，这样的帧频（75/120 FPS）可能会对性能较弱的 CPU 造成性能问题。在 EGLFS 上，捕捉帧频目前锁定为 30 FPS。

另请参阅 WindowCapture 和CaptureSession 。

属性文档