FFmpeg CLI Wrapper 项目中的输入选项构建器改进

在视频处理领域，FFmpeg 是一个功能强大的开源工具，而 FFmpeg CLI Wrapper 项目则是对 FFmpeg 命令行工具的 Java 封装。近期，该项目针对输入选项的构建功能进行了重要改进，解决了长期以来存在的多输入参数配置问题。

原有架构的局限性

在原始版本中，FFmpeg CLI Wrapper 缺乏对每个输入流单独配置参数的能力。这意味着当用户需要处理多个输入源时，无法为每个输入单独设置不同的参数。例如，以下典型的多输入 FFmpeg 命令就无法通过原有 API 构建：

ffmpeg -f lavfi -i "testsrc=duration=10:size=1280x720:rate=30" -f lavfi -i "sine=frequency=1000:sample_rate=48000:duration=10" -c:a aac -c:v h264 output.mp4

这种限制导致开发者不得不使用 addExtraArgs 方法进行变通处理，但这违背了封装库的设计初衷，降低了代码的可读性和可维护性。

新引入的 FFmpegInputBuilder

为了解决这一问题，项目引入了 FFmpegInputBuilder 类，它允许为每个输入流单独配置参数。这一改进带来了以下优势：

1. 精细化的输入控制：可以为每个输入源独立设置格式、分辨率、帧率等参数
2. 更好的类型安全：通过构建器模式避免了字符串拼接可能带来的错误
3. 更清晰的API设计：参数配置逻辑更加直观，代码可读性提高

实际应用场景

在实际开发中，这一改进特别适用于以下场景：

1. 原始视频处理：当处理原始视频数据时，需要指定视频尺寸、像素格式等参数

new FFmpegBuilder()
    .addInput(new FFmpegInputBuilder()
        .setInput("unix://socket")
        .setFormat("rawvideo")
        .setVideoSize(1280, 720)
        .setPixelFormat("bgr24")
        .setFrameRate(30))
    .addOutput("output.mp4")
    .build();

2. 实验性编解码器支持：处理新兴视频格式如H.266/VVC时，需要设置严格模式

new FFmpegBuilder()
    .addInput(new FFmpegInputBuilder()
        .setInput("input.h266")
        .setStrict(StrictMode.EXPERIMENTAL))
    .addOutput("output.mp4")
    .build();

3. 多输入合成：同时处理视频和音频输入源，各自使用不同的参数

new FFmpegBuilder()
    .addInput(new FFmpegInputBuilder()  // 视频输入
        .setInput("video_source")
        .setFormat("lavfi")
        .setVideoSize(1920, 1080))
    .addInput(new FFmpegInputBuilder()  // 音频输入
        .setInput("audio_source")
        .setSampleRate(48000))
    .addOutput("output.mp4")
    .build();

相关技术细节

1. B帧控制：在实际应用中，许多设备不支持B帧，可以通过构建器明确禁用

new FFmpegOutputBuilder()
    .setBFrames(0)  // 禁用B帧
    .build();

2. 严格模式：对于实验性编解码器，需要设置严格模式为-2（实验性）

new FFmpegInputBuilder()
    .setStrict(StrictMode.EXPERIMENTAL)
    .build();

3. 像素格式指定：处理原始视频数据时需要明确指定像素格式

new FFmpegInputBuilder()
    .setPixelFormat("yuv420p")  // 常用像素格式
    .build();

总结

FFmpeg CLI Wrapper 项目通过引入 FFmpegInputBuilder，显著提升了多输入场景下的参数配置能力。这一改进不仅解决了长期存在的功能限制，还通过构建器模式提供了更加类型安全、可读性更强的API设计。对于需要进行复杂视频处理的Java开发者来说，这一改进将大大简化开发流程，减少错误发生概率，提高代码的可维护性。

在实际应用中，开发者现在可以更加方便地处理原始视频数据、支持新兴编解码器以及实现复杂的多输入合成场景，而无需再依赖容易出错的字符串拼接方式。这一改进标志着该项目在API设计上的成熟，为未来的功能扩展奠定了良好的基础。