FFmpeg の `-map` パラメータの詳細な説明: ビデオ、オーディオ、および字幕ストリームの正確な選択

マルチオーディオトラックおよびマルチ字幕ビデオ処理では、-map は FFmpeg の最も重要で最も誤用されやすいパラメータの 1 つです。

-map を明示的に指定しない場合、FFmpeg はデフォルトのルールに従ってストリームを自動的に選択するため、多くの場合、期待した結果が得られません。例えば：

この記事では、最も一般的なシナリオを使用して、-map の使用方法を説明します。

まずは「流れ」とは何かを理解する

通常、コンテナーファイルには複数のコンテンツストリーム (ストリーム) が存在します (mp4、mkv など)。一般的なものには次のようなものがあります。

まず ffprobe を使用して、ファイル内にどのようなストリームがあるかを確認できます。

1

ffprobe -hide_banner input.mkv

最も一般的な書き方は次のとおりです。

1

-map input_index[:stream_type][:stream_index]

例えば：

例証します:

1
2
3
4


ffmpeg -i english.mp4 -i french.mp3 \
  -map 0:v:0 -map 1:a:0 \
  -c:v copy -c:a aac \
  french.mp4

意味：

1
2
3
4


ffmpeg -i english.mp4 -i french.mp3 \
  -map 0 -map 1:a:0 \
  -c copy \
  english-french.mp4

意味：

たとえば、最初の入力のすべてのストリームを保持しますが、2 番目のオーディオストリームを削除します。

1

ffmpeg -i input.mkv -map 0 -map -0:a:1 -c copy output.mkv

一部のファイルには字幕がない場合があります。その場合は、? を使用できます。

1

ffmpeg -i input.mp4 -map 0:v -map 0:a -map 0:s? -c copy output.mp4

0:s? は、「字幕がある場合はマップし、字幕がない場合はスキップし、エラーは報告されない」ことを意味します。

-map を使用すると、FFmpeg はデフォルトでストリームを自動的に選択しなくなるため、必要なものをすべて書き出す必要があります。
-c copy は、トランスコーディングを行わずにカプセル化とコピーのみを行います。ターゲットコンテナが特定のエンコーディングをサポートしていない場合でも、失敗します。
複数の入力を入力するときに最もよくある間違いは、シリアル番号を入力することです。シリアル番号は -i の順序にのみ依存することに注意してください。
安定したスクリプトを作成したい場合は、まず ffprobe を作成し、次に手書きよりも安定した -map を生成します。

-map の中核は 1 つの文です。「どの入力から、どのタイプのストリームを取得し、どのストリームを取得するか」を FFmpeg に明確に指示します。

マスタリング後は、複数のオーディオトラック、複数の字幕、ファイル間の結合などの複雑なシーンを安定して処理できるようになり、「エクスポート結果が間違っているが原因がわからない」という問題を回避できます。