FFmpeg と JavaCV による Java での効率的な動画分割
動画の分割では、音声と再生タイミングを保持する必要があります。FFmpegFrameGrabber.grab() の呼び出し回数では、動画の長さを測定できません。呼び出しは音声ブロックまたは動画フレームを返すためです。可変フレームレートの場合も、フレーム数に基づく計算は信頼できません。
この例では JavaCV で入力を調べ、同梱の FFmpeg 実行ファイルで圧縮パケットを分割します。タイムスタンプと音声のインターリーブは FFmpeg が管理します。入力ファイル名をシェルが解釈することはありません。
動画を分割する理由は?
セグメントは、編集、ダウンロードの分散配信、個別の処理に役立ちます。単独の MP4 セグメントだけでは、アダプティブストリーミング用のメディア構成にはなりません。HLS や DASH には、マニフェストと適切にエンコードされたレンディションも必要です。
Java 環境のセットアップ
テスト済みの Linux 環境では、JDK 21.0.12.1 と Maven 3.9.16 を使用します。以下を pom.xml として保存し、後述の
VideoSplitter.java を src/main/java/ に配置してください。このバージョン指定では JavaCV 1.5.14 と
FFmpeg 8.1.2-1.5.14 を使用します。
<project xmlns="http://maven.apache.org/POM/4.0.0">
<modelVersion>4.0.0</modelVersion>
<groupId>example</groupId>
<artifactId>video-splitter</artifactId>
<version>1.0</version>
<properties>
<maven.compiler.release>21</maven.compiler.release>
<javacpp.platform>macosx-arm64</javacpp.platform>
</properties>
<dependencies>
<dependency>
<groupId>org.bytedeco</groupId><artifactId>javacv</artifactId><version>1.5.14</version>
<exclusions><exclusion><groupId>*</groupId><artifactId>*</artifactId></exclusion></exclusions>
</dependency>
<dependency>
<groupId>org.bytedeco</groupId><artifactId>javacpp</artifactId><version>1.5.14</version>
</dependency>
<dependency>
<groupId>org.bytedeco</groupId><artifactId>javacpp</artifactId><version>1.5.14</version>
<classifier>${javacpp.platform}</classifier>
</dependency>
<dependency>
<groupId>org.bytedeco</groupId><artifactId>ffmpeg</artifactId><version>8.1.2-1.5.14</version>
</dependency>
<dependency>
<groupId>org.bytedeco</groupId><artifactId>ffmpeg</artifactId><version>8.1.2-1.5.14</version>
<classifier>${javacpp.platform}</classifier>
</dependency>
</dependencies>
<build><plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId><artifactId>maven-compiler-plugin</artifactId>
<version>3.14.1</version>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId><artifactId>maven-dependency-plugin</artifactId>
<version>3.8.1</version>
</plugin>
</plugins></build>
</project>
javacpp.platform を実際のプラットフォームに設定してください。たとえば、linux-x86_64 を macosx-arm64 の代わりに指定します。これにより、必要なネイティブアーティファクトだけをダウンロードします。対応プラットフォームは JavaCV のインストール手順で確認してください。
ffmpegframegrabber と ffmpegframerecorder の仕組み
FFmpegFrameGrabber は画像とサンプルをデコードできます。FFmpegFrameRecorder.record(frame) は、入力と同じコーデックを選択しても、デコード済みのフレームを再びエンコードします。コーデックの選択はストリームコピーではありません。
映像を編集せずに分割するため、以下のサブプロセスでは FFmpeg の
-c copy によるパケット処理を使用します。最初の動画ストリームと、存在する場合は最初の音声ストリームを保持します。追加の音声トラック、字幕、チャプター、回転メタデータ、任意のコンテナメタデータは、この例で保持を保証する対象には含まれません。ストリームマッピングを拡張する前に、それぞれを個別に検証してください。
動画分割の手順
このクラス全体を VideoSplitter.java として保存してください。実行に失敗しても以前の結果を上書きしないよう、出力ディレクトリは未作成である必要があります。FFmpeg が失敗した場合、診断用に不完全なファイルがそのディレクトリに残ります。破損のない入力を使用し、出力ディレクトリを利用する前に、後述の手順でセグメントを検証してください。grabber が確認するのはメタデータです。パケットコピーでは、メディア全体をデコードして検証しません。
import java.io.IOException;
import java.math.BigDecimal;
import java.nio.file.Files;
import java.nio.file.Path;
import java.util.concurrent.TimeUnit;
import org.bytedeco.javacpp.Loader;
import org.bytedeco.javacv.FFmpegFrameGrabber;
public final class VideoSplitter {
public static void split(Path input, Path output, double seconds) throws Exception {
if (!Double.isFinite(seconds) || seconds <= 0) {
throw new IllegalArgumentException("Segment duration must be positive and finite");
}
Path source = input.toRealPath();
if (!Files.isRegularFile(source)) throw new IOException("Input must be a regular file");
try (FFmpegFrameGrabber grabber = new FFmpegFrameGrabber(source.toFile())) {
grabber.start();
if (grabber.getImageWidth() <= 0) throw new IOException("Input has no video stream");
}
Files.createDirectory(output);
Path destination = output.toRealPath();
String executable = Loader.load(org.bytedeco.ffmpeg.ffmpeg.class);
Process process = new ProcessBuilder(
executable, "-hide_banner", "-nostdin", "-v", "error", "-xerror", "-n",
"-i", source.toString(), "-map", "0:v:0", "-map", "0:a:0?",
"-c", "copy", "-f", "segment", "-segment_format", "mp4",
"-segment_time", BigDecimal.valueOf(seconds).toPlainString(), "-reset_timestamps", "1",
"segment-%03d.mp4"
).directory(destination.toFile()).redirectErrorStream(true)
.redirectOutput(destination.resolve("ffmpeg.log").toFile()).start();
try {
if (!process.waitFor(10, TimeUnit.MINUTES)) throw new IOException("FFmpeg timed out");
if (process.exitValue() != 0) throw new IOException("FFmpeg failed; inspect ffmpeg.log");
} finally {
if (process.isAlive()) {
process.destroyForcibly();
process.waitFor();
}
}
}
public static void main(String[] args) throws Exception {
if (args.length != 3) throw new IllegalArgumentException("input output-directory seconds");
split(Path.of(args[0]), Path.of(args[1]), Double.parseDouble(args[2]));
}
}
macOS または Linux では、次のコマンドでコンパイルして実行します。
mvn compile dependency:copy-dependencies &&
java -cp 'target/classes:target/dependency/*' VideoSplitter input.mp4 segments 10
FFmpeg は、指定した境界以降の動画キーフレームでセグメントを開始します。10 秒という指定は目標であり、正確な切断位置ではありません。最後のセグメントは短くなる場合があり、キーフレームの間隔が広いと、セグメントが大幅に長くなる場合もあります。音声パケットは相対的なタイミングを保持しますが、その境界は動画フレームと必ずしも完全に一致するとは限りません。編集上の境界を正確に指定するには、意図した位置にキーフレームを配置して再エンコードする必要があります。segment muxer のドキュメントを参照してください。
性能向上のためのマルチスレッド実装
各入力のパケットストリームは順次処理してください。複数のデコーダーを起動して音声と動画が混在するフレームを数えると、シーク境界で音声が欠落したり、コンテンツが重複したりすることがあります。独立した入力ファイルには、並行実行数に上限のあるエグゼキューターを使用し、ジョブごとに専用の出力ディレクトリを割り当ててください。投入したすべてのジョブで Future.get() を呼び出し、失敗を呼び出し元へ伝播させます。並行実行数を増やす前にスループットを測定してください。パケットコピーは、ストレージ性能に制限されることが多いためです。
パフォーマンス最適化のヒント
ストリームコピーは、エンコード処理と再エンコードによる品質劣化を回避します。出力コンテナと互換性のあるコーデックが必要です。非対応のコーデックでは、ストリームを黙って失うのではなく、明示的に失敗するべきです。サイズ変更、透かしの追加、コーデック変更には別のトランスコードワークフローを使用し、その音声とタイミングの挙動もテストしてください。
エラー処理のベストプラクティス
この例では、正でない長さや有限でない長さ、存在しない入力、既存の出力ディレクトリを拒否します。長さにはロケールに依存しない通常の小数表記を使用し、0.0001 秒のような小さな値も指定できます。ただし、FFmpeg の時間精度と範囲の制約は適用されます。Java の
double が正の有限値であるだけでは、FFmpeg で表現できる長さとは限りません。エラーとタイムアウトは失敗として伝播します。FFmpeg の -xerror オプションは、デマルチプレクサーが報告した破損パケットを含め、検出したエラーで処理を停止します。正常に終了しても、出力の検証は必要です。ストリームコピーでは、デコーダーでしか検出できない破損がそのまま通過することがあります。ffmpeg.log にはファイルパスが含まれる可能性があるため、非公開にしてください。プロセスを分離してもサンドボックスにはなりません。信頼できないメディアは、ワーカー環境でファイルシステム、ネットワーク、CPU、メモリの制限を強制したうえで処理してください。
動画処理を最適化する実践的なヒント
音声あり、可変フレームレート、音声なしの入力を含め、実際の出力を調べてください。ffmpeg と ffprobe を別途インストールし、プロジェクトディレクトリから次を実行して、すべてのセグメントを調べてデコードします。サブシェルは、最初の検証失敗で停止します。
(
set -e
for segment in segments/segment-*.mp4; do
ffprobe -v error -show_streams -show_format -of json "$segment"
ffmpeg -v error -xerror -err_detect explode -i "$segment" \
-map 0:v:0 -map '0:a:0?' -f null -
done
)
コマンドが成功しても、診断情報を確認してください。動画と音声それぞれのパケット総数とペイロードを入力と比較し、完全であることがわかっているソースに照らして、想定どおりの終端になっているかを確認します。キーフレームに合わせたセグメント長と、コンテナのタイムスタンプオフセットを考慮してください。ファイルの存在を確認するだけでは、内容が保持されたとは判断できません。
まとめと追加リソース
内容の調査には JavaCV を、再エンコードしない効率的な分割には FFmpeg のパケットセグメンターを使用します。アダプティブストリーミングについては、Transloadit の動画エンコーディングサービスと 🤖 /video/adaptive Robotを参照してください。
