QScreenCapture Class

詳細説明

このクラスは画面をキャプチャします。このクラスはQMediaCaptureSession クラスによって管理され、キャプチャした画面をビデオ・プレビュー・オブジェクトに表示したり、ファイルに記録したりすることができます。

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

画面キャプチャの制限

Qt 6.5.2以降では、QScreenCaptureの使用には以下の制限があります：

• FFmpegバックエンドでのみサポートされています。
• Waylandコンポジタを使用するLinuxシステムでは、スクリーンキャプチャの実装は実験的であり、以下の制限があります。Waylandプロトコルの制限により、QScreenCapture クラスのAPIを介してターゲット画面を設定および取得することはできません。代わりに、QScreenCapture::setActive(true) を起動すると、OSは画面選択ウィザードを表示します。画面キャプチャ機能を使用するには、XDG Desktop Portalおよび {https://pipewire.org/}{PipeWire} (0.3) を介してサポートされるScreenCastサービスのインストールが必要です。これらの制限は将来変更される可能性があります。
• Android 以外のモバイル OS ではサポートされていません。Android での Screen Capture は、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 を介して実装されているため、パフォーマンス上の問題が発生する可能性があります。
• ほとんどの場合、画面のリフレッシュ・レートに等しい画面キャプチャ・フレーム・レートを設定します。このようなフレームレート（75/120 FPS）は、キャプチャされた画面が4K解像度の場合、弱いCPUでパフォーマンスの問題を引き起こす可能性があります。EGLFSでは、キャプチャフレームレートは現在30 FPSに固定されています。