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

このページでは Qt Multimedia.この説明は、Qt Configure Options の概要と同様に、お使いのプラットフォームのビルド要件を指定するBuilding Qt Sourcesに精通していることを前提としています。Qt Multimedia モジュールに関連するプラットフォーム固有の考慮事項については、以下の「プラットフォームに関する注意事項」を参照してください。

ソースからのビルド

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

Qt Multimedia のビルドに必要な FFmpeg 開発ライブラリは、ソースからビルドすることも、バイナリパッケージとしてダウンロードすることもできます。Qt Multimedia は、FFmpeg ライブラリへのスタティックリンクまたはダイナミックリンクのいずれかを使用できます。デフォルトのバックエンドとして、FFmpegにリストされているFFmpegの同じメジャーバージョンを使用することをお勧めします。FFmpeg開発ライブラリのビルド方法については、FFmpegをソースからビルドするを参照してください。

FFmpeg をサポートしたQt Multimedia をビルドするには、Qt のビルド時に configure コマンドラインで CMake 変数-DFFMPEG_DIR を指定します。通常のconfigure引数とCMakeパラメータを区切る-- セパレータに注意してください。

qt-source/configure -- -DFFMPEG_DIR=<FFMPEG_DIR>

ここで、<FFMPEG_DIR> は FFmpeg のインクルード、lib、bin ディレクトリを含むディレクトリです。FFmpeg なしでQt Multimedia をビルドするには、<FFMPEG_DIR> 変数を省略し、-no-feature-ffmpeg configure オプションを指定します。

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

qt-source/configure -submodules qtmultimedia -- -DFFMPEG_DIR=<FFMPEG_DIR>

共有ライブラリでビルドされた FFmpeg に対してQt Multimedia を設定する場合（ダイナミックリンク）、テストを実行したりサンプルを使用したりするには、FFmpeg 共有ライブラリがモジュールローダーの検索パスになければなりません。

path にこれらのライブラリがまだない場合は、-DQT_DEPLOY_FFMPEG=ON configure オプションを指定してください。このオプションを有効にすると、ビルドとインストールのステップで、必要な FFmpeg バイナリが Qt のインストール・ディレクトリにコピーされます：

qt-source/configure -submodules qtmultimedia -- -DFFMPEG_DIR=<FFMPEG_DIR> -DQT_DEPLOY_FFMPEG=ON

Qt Multimedia を設定した後、configure の概要（config.summary ファイルにあります）を注意深く確認してください。FFmpegが "Plugin "セクションの下にあることを確認できます。その後、Qt ソースのビルドで説明されている、通常のビルドとインストールの手順に従います。

プラットフォーム

Linux

• FFmpeg を有効にしてQt Multimedia を設定する場合、pulseaudio development パッケージが必要です。このパッケージがないと、FFmpeg は認識されません。
• VAAPIサポートでビルドされたFFmpegのバージョンを使用する場合は、ハードウェア・テクスチャ変換を可能にするために、VAAPIサポートでQt Multimedia 。VAAPIサポートでQt Multimedia を設定するには、VAAPI開発者ライブラリがシステムにインストールされている必要があります。config.summaryファイルを見て、"Hardware acceleration and features "セクションでVAAPIサポートが有効になっていることを確認してください。
• GStreamerバックエンドでQt Multimedia を設定する場合、GStreamer v1.20が最低要件です。ただし、可能であれば最新の安定版GStreamerアップストリームリリースを使用することをお勧めします。