java springboot ffmpg

### Java SpringBoot项目中集成和使用FFmpeg

#### 1. 添加Maven依赖
为了在Spring Boot应用程序中调用FFmpeg命令行工具，首先需要确保项目的构建工具（如Maven）能够访问必要的库。对于简单的命令执行功能，通常不需要额外的Java库来直接运行外部程序。

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter</artifactId>
</dependency>

<!-- 如果计划解析或处理媒体元数据 -->
<dependency>
    <groupId>com.github.sulir.rtmp-rtsp-stream-client-java</groupId>
    <artifactId>streaming-proto-commons</artifactId>
    <version>1.0.0</version>
</dependency>

#### 2. 下载并配置FFmpeg
根据操作系统不同，获取适合平台的预编译二进制文件[^4]。对于Windows用户来说，可以从指定链接下载`ffmpeg-7.0.2-essentials_build.zip`压缩包，并解压至合适位置；而对于Linux服务器，则建议按照官方文档指导完成源码编译安装过程[^3]。无论哪种方式，在完成后都需设置好环境变量以便后续通过命令行调用该软件。

#### 3. 创建Service类封装转换逻辑
定义一个名为`VideoProcessingService`的服务层组件用于管理所有的音视频操作请求：

@Service
public class VideoProcessingService {

    private static final Logger logger = LoggerFactory.getLogger(VideoProcessingService.class);

    @Value("${ffmpeg.path}")
    private String ffmpegPath;

    public void convertToMp4(String inputFilePath, String outputFilePath) throws IOException {
        ProcessBuilder pb = new ProcessBuilder(
            ffmpegPath,
            "-i", inputFilePath,
            "-c:v", "libx264",
            "-preset", "ultrafast",
            "-strict", "-2",
            outputFilePath);
        
        try (Process process = pb.start()) {
            int exitCode = process.waitFor();
            if (exitCode != 0) {
                throw new RuntimeException("Failed to execute FFmpeg command.");
            }
        } catch (InterruptedException e) {
            Thread.currentThread().interrupt(); // Restore interrupted status
            throw new RuntimeException(e);
        }

        logger.info("Conversion completed successfully from {} to {}", inputFilePath, outputFilePath);
    }
}

上述代码片段展示了如何创建一个新的进程实例以异步方式启动FFmpeg进行格式转换工作。这里假设已经在application.properties文件里指定了正确的路径属性`${ffmpeg.path}`指向本地已安装好的可执行文件地址。

#### 4. 控制器接口设计
最后一步就是暴露RESTful API供前端或其他微服务调用了。下面是一个简单的例子说明怎样接收上传文件作为输入参数之一：

@RestController
@RequestMapping("/api/video")
public class VideoController {

    @Autowired
    private VideoProcessingService videoService;
    
    @PostMapping("/convert")
    public ResponseEntity<String> handleFileUpload(@RequestParam("file") MultipartFile file){
        File tempInputFile = null;
        File outputFile = null;
        try{
            tempInputFile = Files.createTempFile(null,"").toFile();
            outputStream.transferFrom(inputStream,tempInputFile.toPath());
            
            Path outputPath = Paths.get(System.getProperty("user.home"),"output.mp4");
            outputFile = outputPath.toFile();

            videoService.convertToMp4(tempInputFile.getAbsolutePath(),outputFile.getAbsolutePath());

            return ResponseEntity.ok("Transcoding complete! Output saved at "+outputFile.getAbsolutePath());
        }catch(Exception ex){
            return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(ex.getMessage());
        }finally{
            if(tempInputFile!=null && !tempInputFile.delete()){
                logger.warn("Unable to delete temporary file:{}",tempInputFile.getName());
            }
        }
    }
}

这段控制器实现了POST /api/video/convert端点的功能，它接受multipart/form-data类型的HTTP POST请求并将其中携带的一个或多個media files传递给后台service去做进一步加工处理。