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を除くモバイルOSではサポートされていません。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に固定されています。