SpringBoot整合FFmpeg的方法

智能工业品检测-奇妙智能2026-03-12 10:51

SpringBoot整合FFmpeg的方法

引入依赖

在pom.xml中添加FFmpeg的Java封装库依赖，例如使用javacv或直接调用本地FFmpeg可执行文件。推荐以下依赖：

XML 复制代码

<dependency>
    <groupId>org.bytedeco</groupId>
    <artifactId>javacv-platform</artifactId>
    <version>1.5.6</version>
</dependency>

配置FFmpeg路径

如果直接调用本地FFmpeg，需确保系统已安装FFmpeg并配置环境变量。或在项目中指定FFmpeg可执行文件路径：

properties 复制代码

# application.properties
ffmpeg.path=/usr/local/bin/ffmpeg

封装工具类

创建一个工具类封装FFmpeg操作，例如视频转码：

java 复制代码

import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;
import java.io.IOException;

@Component
public class FfmpegUtil {
    @Value("${ffmpeg.path}")
    private String ffmpegPath;

    public void convertVideo(String inputPath, String outputPath) throws IOException {
        String command = String.format("%s -i %s -c:v libx264 -crf 23 %s", 
            ffmpegPath, inputPath, outputPath);
        Runtime.getRuntime().exec(command);
    }
}

异常处理与异步调用

FFmpeg操作可能耗时较长，建议异步执行并捕获异常：

java 复制代码

import org.springframework.scheduling.annotation.Async;
import org.springframework.stereotype.Service;

@Service
public class VideoService {
    private final FfmpegUtil ffmpegUtil;

    public VideoService(FfmpegUtil ffmpegUtil) {
        this.ffmpegUtil = ffmpegUtil;
    }

    @Async
    public void processVideoAsync(String input, String output) {
        try {
            ffmpegUtil.convertVideo(input, output);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

测试验证

编写测试用例验证功能：

java 复制代码

@SpringBootTest
public class FfmpegTest {
    @Autowired
    private VideoService videoService;

    @Test
    public void testConvert() {
        videoService.processVideoAsync("input.mp4", "output.mp4");
        // 添加断言或日志验证
    }
}

高级功能扩展

通过FFmpeg可实现更多功能，例如截图生成：

java 复制代码

public void captureThumbnail(String videoPath, String imagePath) throws IOException {
    String command = String.format("%s -i %s -ss 00:00:01 -vframes 1 %s", 
        ffmpegPath, videoPath, imagePath);
    Runtime.getRuntime().exec(command);
}

注意事项

确保服务器已安装FFmpeg并验证版本兼容性
处理大文件时注意内存和线程管理
生产环境建议使用消息队列异步处理任务
Windows系统需注意路径中的空格和转义字符