QWindowCapture Class

このクラスはウィンドウをキャプチャするために使用します。詳細...

Header: #include <QWindowCapture>
CMake: find_package(Qt6 REQUIRED COMPONENTS Multimedia)
target_link_libraries(mytarget PRIVATE Qt6::Multimedia)
qmake: QT += multimedia
Since: Qt 6.6
In QML: WindowCapture
Inherits: QObject

パブリックタイプ

enum Error { NoError, InternalError, CapturingNotSupported, CaptureFailed, NotFound }

プロパティ

パブリック関数

QWindowCapture(QObject *parent = nullptr)
virtual ~QWindowCapture() override
QWindowCapture::Error error() const
QString errorString() const
bool isActive() const
void setWindow(QCapturableWindow window)
QCapturableWindow window() const

パブリックスロット

void setActive(bool active)
void start()
void stop()

シグナル

void activeChanged(bool)
void errorChanged()
void errorOccurred(QWindowCapture::Error error, const QString &errorString)
void windowChanged(QCapturableWindow window)

静的パブリックメンバ

QList<QCapturableWindow> capturableWindows()

詳細説明

このクラスはウィンドウをキャプチャします。QMediaCaptureSession クラスによって管理され、キャプチャされたウィンドウはビデオ プレビュー オブジェクトに表示されるか、ファイルに記録されます。

ウィンドウ キャプチャの制限事項

QWindowCaptureの使用には以下の制限があります:

  • QWindowCapture は FFmpeg バックエンドでのみサポートされています。

QMediaCaptureSession およびQCapturableWindowも参照してください

メンバ タイプ ドキュメント

enum QWindowCapture::Error

QWindowCapture クラスがシグナルできるエラーコードを列挙します。errorString() は、エラーの原因に関する詳細情報を提供します。

定数説明
QWindowCapture::NoError0エラーなし
QWindowCapture::InternalError1内部ウィンドウキャプチャドライバエラー
QWindowCapture::CapturingNotSupported2ウィンドウのキャプチャはサポートされていません
QWindowCapture::CaptureFailed4ウィンドウのキャプチャに失敗しました
QWindowCapture::NotFound5選択されたウィンドウが見つからない

プロパティ説明

active : bool

このプロパティは、キャプチャが現在アクティブであるかどうかを保持する。

アクセス関数

bool isActive() const
void setActive(bool active)

通知シグナル:

void activeChanged(bool)

start() およびstop()も参照のこと

[read-only] error : const Error

このプロパティは、最後のエラーのコードを保持する。

アクセス関数:

QWindowCapture::Error error() const

Notifier シグナル:

void errorChanged()

[read-only] errorString : const QString

このプロパティには、エラーの原因を示す可読文字列が格納されます。

アクセス関数:

QString errorString() const

ノーティファイアシグナル

void errorChanged()

window : QCapturableWindow

このプロパティは、キャプチャ用のウィンドウを保持します。

アクセス関数

QCapturableWindow window() const
void setWindow(QCapturableWindow window)

ノーティファイアシグナル:

void windowChanged(QCapturableWindow window)

QWindowCapture::capturableWindowsも参照

メンバ関数 ドキュメント

[explicit] QWindowCapture::QWindowCapture(QObject *parent = nullptr)

parent を持つ新しい QWindowCapture オブジェクトを構築します。

[override virtual noexcept] QWindowCapture::~QWindowCapture()

オブジェクトを破棄します。

[static invokable] QList<QCapturableWindow> QWindowCapture::capturableWindows()

キャプチャ可能なQCapturableWindow オブジェクトのリストを返します。

注意: この関数はメタ オブジェクト システムや QML から呼び出すことができます。Q_INVOKABLE を参照してください。

[signal] void QWindowCapture::errorOccurred(QWindowCapture::Error error, const QString &errorString)

error が発生したときに、errorString とともにシグナルを送ります。

[slot] void QWindowCapture::start()

window のキャプチャを開始します。

これはactive プロパティを true に設定することと同じです。

[slot] void QWindowCapture::stop()

キャプチャを停止します。

これはactive プロパティを false に設定することと同じです。

本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。