SpringBoot集成FFmpeg实现多媒体处理_Java

一、简述

在现代 web 应用中，音视频处理需求越来越常见，例如：视频转码、截图、音频提取、格式转换等。ffmpeg 是一个功能极其强大的开源音视频处理工具，可以帮助我们高效完成这些任务。本文将介绍如何在 spring boot 项目中集成 ffmpeg，并实现一些常见的应用场景。

二、为什么选择 ffmpeg

跨平台：支持 windows、linux、macos。
强大功能：转码、剪辑、截图、推流、合并分割等应有尽有。
社区活跃：资料丰富、持续更新。

spring boot + ffmpeg，可以快速构建出一个支持多媒体处理的服务。

1、准备工作

在开发/部署机器上需要安装 ffmpeg，并配置环境变量。

linux/macos：

# macos (homebrew)
brew install ffmpeg

# ubuntu
sudo apt-get install ffmpeg

windows：前往 ffmpeg 官网下载编译好的版本，解压后将 bin 路径加入系统环境变量。

测试是否成功：

ffmpeg -version

2、集成方案

在 java 中调用 ffmpeg 主要有两种方式：

直接调用命令行（通过 processbuilder 或 runtime.exec）
使用 java 封装库（如 jave、ffmpeg cli wrapper）

下面重点演示 命令行调用方式，因为它灵活、依赖少，适合快速上手。

三、实践样例

1、定义工具类调用 ffmpeg

package com.example.ffmpeg.util;

import java.io.bufferedreader;
import java.io.inputstreamreader;

public class ffmpegutil {

    /**
     * 执行 ffmpeg 命令
     *
     * @param command ffmpeg 命令字符串
     * @throws exception
     */
    public static void executecommand(string command) throws exception {
        processbuilder builder = new processbuilder(command.split(" "));
        builder.redirecterrorstream(true);
        process process = builder.start();

        // 输出日志
        try (bufferedreader reader = new bufferedreader(
                new inputstreamreader(process.getinputstream()))) {
            string line;
            while ((line = reader.readline()) != null) {
                system.out.println("[ffmpeg] " + line);
            }
        }

        int exitcode = process.waitfor();
        if (exitcode != 0) {
            throw new runtimeexception("ffmpeg 执行失败，退出码：" + exitcode);
        }
    }
}

2、常见应用场景

视频转码

string cmd =  "ffmpeg -i input.mp4 output.avi";
ffmpegutil.executecommand(cmd);

视频截图

string cmd = "ffmpeg -i input.mp4 -ss 00:00:05 -vframes 1 output.jpg";
ffmpegutil.executecommand(cmd);

提取音频

string cmd = "ffmpeg -i input.mp4 -q:a 0 -map a output.mp3";
ffmpegutil.executecommand(cmd);

3、提供 rest 接口

package com.example.ffmpeg.controller;

import com.example.ffmpeg.util.ffmpegutil;
import org.springframework.web.bind.annotation .*;

@restcontroller
@requestmapping("/ffmpeg")
public class ffmpegcontroller {

    @getmapping("/screenshot")
    public string screenshot(@requestparam string input, @requestparam string output) {
        try {
            string cmd = string.format("ffmpeg -i %s -ss 00:00:02 -vframes 1 %s", input, output);
            ffmpegutil.executecommand(cmd);
            return "截图成功，输出文件：" + output;
        } catch (exception e) {
            return "截图失败：" + e.getmessage();
        }
    }
}

这样，我们就可以通过 http 调用来触发 ffmpeg 的多媒体处理任务。