FFmpeg怎么集成Java？

本文目录导读：

1. 方案一：通过 Runtime 执行命令行（推荐，简单稳定）
2. 方案二：使用 JavaCV（基于 JNI，功能更丰富）
3. 方案三：JNI 直接调用（不推荐）
4. 总结建议

集成 FFmpeg 与 Java 主要有两种主流方式：命令行调用（最常用、最稳定）和 JNI 封装（如 JavaCV 库）,以下是详细的方案介绍和对比。

通过 Runtime 执行命令行（推荐，简单稳定）

这是最常用的方式，Java 程序直接调用系统安装的 FFmpeg 可执行文件。

环境准备

• 安装 FFmpeg：确保 FFmpeg 已安装在系统 PATH 中，或你知道其完整路径。
  • Windows：下载 exe 文件并配置环境变量。
  • Linux/Mac：apt install ffmpeg 或 brew install ffmpeg。
• 验证：终端输入 ffmpeg -version 能正常显示。

Java 代码示例

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
public class FFmpegCommandRunner {
    /**
     * 执行 FFmpeg 命令，支持实时输出与错误流捕获
     * @param command 完整命令，{"ffmpeg", "-i", "input.mp4", "output.gif"}
     * @param timeoutMs 超时时间（毫秒），0 表示不超时
     * @return 进程退出码（0 通常表示成功）
     */
    public static int executeFFmpeg(String[] command, long timeoutMs) throws IOException, InterruptedException {
        ProcessBuilder processBuilder = new ProcessBuilder(command);
        // 合并错误流到标准输出，方便日志记录
        processBuilder.redirectErrorStream(true);
        Process process = processBuilder.start();
        // 异步读取输出流，防止缓冲区满导致阻塞
        StringBuilder output = new StringBuilder();
        Thread outputReader = new Thread(() -> {
            try (BufferedReader reader = new BufferedReader(
                    new InputStreamReader(process.getInputStream()))) {
                String line;
                while ((line = reader.readLine()) != null) {
                    output.append(line).append("\n");
                    // 可选：实时打印日志
                    System.out.println("[FFmpeg] " + line);
                }
            } catch (IOException e) {
                // 处理异常
            }
        });
        outputReader.setDaemon(true);
        outputReader.start();
        // 等待进程完成（支持超时）
        boolean finished;
        if (timeoutMs > 0) {
            finished = process.waitFor(timeoutMs, java.util.concurrent.TimeUnit.MILLISECONDS);
            if (!finished) {
                process.destroyForcibly();
                throw new RuntimeException("FFmpeg command timed out after " + timeoutMs + "ms");
            }
        } else {
            process.waitFor();
        }
        outputReader.join(1000); // 等待读取线程结束
        int exitCode = process.exitValue();
        return exitCode;
    }
    public static void main(String[] args) {
        try {
            // 示例：将 MP4 转换为 GIF
            String[] cmd = {"ffmpeg", "-i", "input.mp4", "-vf", "fps=10,scale=320:-1", "output.gif"};
            int exitCode = executeFFmpeg(cmd, 30000); // 30秒超时
            System.out.println("Exit code: " + exitCode);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

进阶技巧

• 进度获取：通过解析 FFmpeg 的 stderr 输出（time=、frame= 字段）可以获取处理进度。
• 命令构建库：使用 ProcessBuilder 构建命令更安全（避免 shell 注入）。
• 日志与错误处理：务必捕获并抛出异常,特别是在生产环境中。

使用 JavaCV（基于 JNI，功能更丰富）

JavaCV 封装了 FFmpeg 的 C API，提供了 Java 接口,无需执行系统命令。

Maven 依赖

<dependency>
    <groupId>org.bytedeco</groupId>
    <artifactId>javacv-platform</artifactId>
    <version>1.5.10</version> <!-- 请使用最新版本 -->
</dependency>

基本用法示例：视频缩略图提取

import org.bytedeco.javacv.FFmpegFrameGrabber;
import org.bytedeco.javacv.Frame;
import org.bytedeco.javacv.Java2DFrameConverter;
import javax.imageio.ImageIO;
import java.awt.image.BufferedImage;
import java.io.File;
public class JavaCVThumbnail {
    public static void main(String[] args) throws Exception {
        // 创建 FrameGrabber
        FFmpegFrameGrabber grabber = new FFmpegFrameGrabber("input.mp4");
        grabber.start();
        // 跳转到第5秒（时间单位为微秒）
        grabber.setTimestamp(5_000_000L);
        Frame frame = grabber.grabImage();
        // 转换为 Java BufferedImage 并保存
        try (Java2DFrameConverter converter = new Java2DFrameConverter()) {
            BufferedImage bufferedImage = converter.getBufferedImage(frame);
            if (bufferedImage != null) {
                ImageIO.write(bufferedImage, "jpg", new File("thumbnail.jpg"));
            }
        }
        grabber.stop();
    }
}

优缺点对比

JNI 直接调用（不推荐）

直接使用 JNI 调用 FFmpeg 的 C 接口，工作量大且容易出内存泄漏问题，除非需要极致的性能或功能定制,否则不建议自行实现。

总结建议

• 普通转码/剪切/截图 → 命令行方案（简单、稳定、调试方便）
• 需要实时处理/流媒体/高精度分析 → JavaCV
• 生产环境：建议将 FFmpeg 命令封装成独立的微服务或使用消息队列异步调用,避免阻塞应用线程。

如果需要更具体的代码实现（例如进度回调、视频拼接、音频提取），可以告诉我你的目标场景,我会给出对应的示例。