ソースからQt Multimedia をビルドする

このページでは、 Qt Multimedia。この説明では、お使いのプラットフォームのビルド要件を規定した「Qtソースのビルド」および「QtのConfigureオプションの概要」について理解していることを前提としています。Qt Multimedia モジュールに関連するプラットフォーム固有の注意事項については、以下の「プラットフォームに関する注意事項」を参照してください。

ソースからのビルド

ほとんどのプラットフォームにおいて、全機能をサポートしたQt Multimedia をビルドするには、FFmpegのヘッダーおよびライブラリが必要です。Qt Multimedia のFFmpegメディアバックエンドを使用せずにQt Multimedia をビルドすることも可能ですが、これはFFmpegバックエンドがサポートされていないプラットフォーム向けにビルドする場合にのみ推奨されます。

Qt Multimedia のビルドに必要なFFmpeg開発用ライブラリは、ソースからビルドするか、バイナリパッケージとしてダウンロードすることができます。Qt Multimedia は、FFmpegライブラリに対して静的リンクまたは動的リンクのいずれかを使用できます。 「ターゲットプラットフォームおよびバックエンドに関する注意事項」に記載されているのと同じメジャーバージョンの FFmpeg を使用することを推奨します。FFmpeg 開発ライブラリのビルド方法については、「ソースからの FFmpeg のビルド」を参照してください。

FFmpeg サポート付きでQt Multimedia をビルドするには、Qt をビルドする際に、configure コマンドラインで `-ffmpeg-dir ` オプションを指定してください。

qt-source/configure -ffmpeg-dir <FFMPEG_DIR>

ここで、<FFMPEG_DIR> は、FFmpeg の include、lib、および bin ディレクトリを含むディレクトリです。FFmpeg を使用せずにQt Multimedia をビルドするには、<FFMPEG_DIR> 変数を省略し、configure オプションとして-no-feature-ffmpeg を指定してください。

ネイティブメディアバックエンドなしでQt Multimedia をビルドするには、-no-feature-xxx を使用して、gstreamer 、native_windows_backend 、native_darwin_backend 、またはnative_android_backend などの対応する機能を除外します。

qt-source/configure -no-feature-gstreamer

Qtのすべてのサブモジュールをビルドしたくない場合は、configureオプション `-submodules ` を使用することで、configureおよびビルド時間を短縮できます。これにより、Qt Multimedia およびその依存関係のみをビルドする構成になります。

qt-source/configure -submodules qtmultimedia -ffmpeg-dir <FFMPEG_DIR>

共有ライブラリ（動的リンク）でビルドされた FFmpeg に対してQt Multimedia を設定する場合、テストを実行したりサンプルを使用したりするには、FFmpeg の共有ライブラリがモジュールローダーの検索パスに含まれている必要があります。

path にこれらのライブラリがまだ含まれていない場合は、-ffmpeg-deploy というconfigureオプションを指定してください。このオプションを有効にすると、ビルドおよびインストール工程中に、必要なFFmpegバイナリがQtのインストールディレクトリにコピーされます：

qt-source/configure -submodules qtmultimedia -ffmpeg-dir <FFMPEG_DIR> -ffmpeg-deploy

Qt Multimedia の設定が完了したら、設定の概要（config.summary ファイルに記載）を注意深く確認してください。「Plugin」セクションに FFmpeg が含まれていることを確認できます。その後、「Qt ソースのビルド」に記載されている通常のビルドおよびインストール手順に従ってください。

プラットフォームに関する注意事項

iOS

• Qt Multimedia をFFmpeg対応で設定する場合、CMakeの構成プロセスは、提供されたFFmpegディレクトリ内の.xcframework ファイルを検索します。.dylib のバイナリを直接使用することはサポートされていません。FFmpegのビルド成果物を.xcframework ファイルにパッケージ化する方法の詳細については、「macOS上のiOS向けFFmpegのソースからのビルド」および「https://developer.apple.com/documentation/xcode/creating-a-multi-platform-binary-framework-bundle」を参照してください。

Linux

• Qt Multimedia をFFmpeg有効設定で構成する場合、pipewireまたはpulseaudioの開発パッケージが必要です。これらのパッケージのいずれかが欠けていると、FFmpegは認識されません。
• VAAPI サポート付きでビルドされた FFmpeg バージョンを使用する場合は、ハードウェアによるテクスチャ変換を可能にするため、Qt Multimedia も VAAPI サポート付きでビルドすることをお勧めします。Qt Multimedia を VAAPI サポート付きで設定するには、システムに VAAPI 開発者向けライブラリがインストールされている必要があります。 config.summary ファイルを確認し、「ハードウェアアクセラレーションと機能」セクションで VAAPI サポートが有効になっていることを確認してください。
• GStreamer バックエンドを使用してQt Multimedia を設定する場合、GStreamer v1.20 が最低要件となります。ただし、可能であれば、GStreamer の最新の安定版アップストリームリリースを使用することを推奨します。