Jaffree: 使用Java操作FFmpeg 和 FFprobe 的命令行封装库

最新推荐文章于 2025-04-28 14:12:47 发布

井章博Church

最新推荐文章于 2025-04-28 14:12:47 发布

阅读量1.1k

点赞数 10

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00653/article/details/141008035

Jaffree: 使用Java操作FFmpeg 和 FFprobe 的命令行封装库

项目地址:https://gitcode.com/gh_mirrors/ja/Jaffree

项目介绍

Jaffree 是一个功能强大的Java库，用于在程序中集成FFmpeg和FFprobe的功能。该项目的主要目标是提供一种简单且透明的方式进行视频处理任务，如转换、裁剪、合并等常见的多媒体文件操作。

主要特性

程序化控制视频生产与消费。
通过java.lang.Process与FFmpeg交互。
支持错误管理，当遇到致命错误时抛出异常。
提供与输入输出流（InputStream和OutputStream）以及SeekableByteChannel的数据交换方式。

许可证

该项目遵循Apache License 2.0许可协议。

快速启动

为了演示如何使用Jaffree执行基本操作，我们将展示一个简单的例子来说明如何从一个视频流捕获帧并将其保存为图片。

步骤一：添加依赖到Maven或Gradle项目中

对于Maven项目:

<dependency>
    <groupId>com.github.kokorin</groupId>
    <artifactId>jaffree</artifactId>
    <version>LATEST_VERSION</version>
</dependency>

替换 LATEST_VERSION 为你希望使用的具体版本号。

对于Gradle项目：

implementation 'com.github.kokorin:jaffree:LATEST_VERSION'

同样地，更新 LATEST_VERSION 到你的实际需求。

步骤二：编写字节通道数据传输示例

import com.github.kokorin.jaffree.Jaffree;
import com.github.kokorin.jaffree.ffmpeg.FFmpeg;

import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.StandardOpenOption;
import java.nio.channels.SeekableByteChannel;

public class QuickStartExample {
    
    public static void main(String[] args) throws IOException {
        String pathToSourceVideo = "/path/to/source/video.mp4";
        String pathToDestinationImage = "/path/to/destination/frame.png";

        try (SeekableByteChannel inputChannel = Files.newByteChannel(
                Paths.get(pathToSourceVideo),
                StandardOpenOption.READ);
             SeekableByteChannel outputChannel = Files.newByteChannel(
                 Paths.get(pathToDestinationImage),
                 StandardOpenOption.CREATE,
                 StandardOpenOption.WRITE,
                 StandardOpenOption.TRUNCATE_EXISTING)
        ) {
            FFmpeg ffmpeg = Jaffree.atPath("/path/to/ffmpeg")
                    .addInput(ChannelInput.fromChannel(inputChannel))
                    .addOutput(ChannelOutput.toChannel(outputChannel))
                    .execute();
            
            System.out.println("Frame captured successfully!");
        }
    }
}

确保将路径替换为本地系统中的正确位置。这个简单的示例展示了如何读取视频源并捕捉其中的一帧作为图像。

应用案例和最佳实践

Jaffree可以应用于广泛的场景，以下是几个典型的应用案例：

示例：创建马赛克视频

假设我们想要从多个视频来源创建一个统一的马赛克视图，我们可以利用Jaffree实现这一过程：

FilterChain.of(
    // 创建自定义滤镜链
    ...  // 这里省略详细代码以保持示例简洁性
).forEach(filter -> ffmpeg.addFilters(filter));
// 添加输出配置
ffmpeg.addOutput(...);   // 完善输出配置细节
ffmpeg.execute();

详细的滤镜链构建及参数设置会在更深入的学习资源中提供。