WindowsでのFFmpegのソースからのビルド

このページでは、Windows でのFFmpegの設定およびビルド方法について説明します。必要な手順は以下の通りです：

• FFmpegのソースコードを入手します。
• 必要な依存関係をインストールする。
• コマンドラインから FFmpeg を設定する。
• 開発用ライブラリをビルドする。

FFmpegのソースコードを入手する

FFmpegのソースコードは、以下の方法で入手できます。

• FFmpegのダウンロードページからダウンロードします。
• Gitからクローンする。たとえば、次のコマンドを実行すると、FFmpegのバージョン9.0.1のソースコードがC:\FFmpeg\ffmpeg にクローンされます。

  git clone --branch n9.0.1 https://git.ffmpeg.org/ffmpeg.git ffmpeg

Qt Multimedia のメインページに記載されているのと同じバージョンの FFmpeg を使用することをお勧めします。

以下の説明では、FFmpegのソースコードをC:\FFmpeg\ffmpeg に保存していることを前提としています。

前提条件

FFmpeg をビルドするには、以下のツールおよびパッケージが必要です：

• Microsoft Visual Studio コンパイラ (MSVC) または MinGW-w64。
• MSYS2。
• MSYS パッケージ（make、yasm）。

Qt でもサポートされている推奨コンパイラについては、「Qt for Windows - ソースからのビルド」を参照してください。サポートされている MinGW-w64 コンパイラは、Qt Online Installer を使用してインストールできます。

MSYS2のインストール

MSYS2 をインストールするには、次の方法があります。

• MSYS2 インストーラを使用する。
• wingetパッケージマネージャーを使用する。

  winget install msys2.msys2

このドキュメントの手順は、MSYS2がC:\msys64\ にインストールされていることを前提としています。これは、winget を使用する場合のデフォルトのパスです。

インストールが完了したら、WindowsのスタートメニューからMSYS2 MINGW64 シェルを起動し、これを使用して必要なライブラリをインストールしてください。

pacman -S --noconfirm make yasm diffutils

FFmpeg をビルドする前に、MSYS2 のPATH にコンパイラがインストールされている必要があります。この設定は、MSVC と MinGW-w64 で異なります。使用するコンパイラに合わせて MSYS2 環境を準備してください。

Mingw-w64 でのビルドに向けた MSYS 環境の準備

C:\Qt\Tools\mingw1310_64\bin にインストールされたMinGW-w64の場合、PATH環境変数をエクスポートすることで、PATH に追加できます。

export PATH=/c/Qt/Tools/mingw1310_64/bin:$PATH

なお、pacman を使用して MinGW-w64 をインストールすることも可能です。

pacman -S mingw-w64-x86_64-toolchain

MSVC 用の MSYS2 環境の準備

MSYS2 環境で MSVC コンパイラを使用して FFmpeg をビルドするには、パスに適切な C および C++ コンパイラが設定された状態で MSYS2 を起動する必要があります。64 ビットビルドの場合は、次の手順を実行します。

• Windowsのスタートメニューから「Visual Studio x64 Native Tools コマンドプロンプト」を起動します。
• 既存のコマンドプロンプトで次のコマンドを実行し、MSVC コンパイラを有効にします:

  "C:\Program Files\Microsoft Visual Studio\2022\BuildTools\VC\Auxiliary\Build\vcvarsall.bat" amd64

このコマンドプロンプトから、MINGW64 環境を選択し、パスの継承を有効にするオプションを指定して MSYS2 シェルを起動します。

C:\msys64\msys2_shell.cmd -mingw64 -full-path

これにより新しいシェルウィンドウが起動し、そこでMSVCコンパイラが利用可能であることを確認できます。

which cl.exe

FFmpeg の設定とビルド

準備した MSYS2 シェルから、/c/FFmpeg ディレクトリに移動します。このディレクトリ内に、FFmpeg のビルド成果物を格納するbuild ディレクトリを作成し、その中に移動します。

cd /c/FFmpeg/build

FFmpegを構成するには、次のコマンドを実行します。

../configure --prefix=../install --disable-doc --enable-network --enable-shared

--prefix 引数は、ビルド後にFFmpegの開発用ライブラリがインストールされるパスを指定します。ドキュメントは不要ですが、ネットワーク機能は有効にしておく必要があります。FFmpegを静的ライブラリとしてビルドする場合は、--enable-shared オプションを省略してください。

MSVC を使用して FFmpeg をビルドするように設定するには、他のコマンドラインオプションに加えて、ツールチェーンを指定します:

../configure --prefix=../install --disable-doc --enable-network --enable-shared --toolchain=msvc

configure コマンドが完了したら、make コマンドを使用して FFmpeg をビルドおよびインストールします。

make -j install

エラーなしでビルドが完了すると、FFmpegの開発用ライブラリはC:\FFmpeg\install ディレクトリにインストールされます。Qt Multimedia でビルドした場合、このパスは、Qt Multimedia の構成時に使用されるFFMPEG_DIR 変数に保存されます。