Java调用FFmpeg进行视频处理及Builder设计模式的应用

1、FFmpeg是什么

FFmpeg（https://www.ffmpeg.org）是一套可以用来记录、转换数字音频、视频，并能将其转化为流的开源计算机程序。它用来干吗呢？视频采集、视频格式转化、视频截图、视频添加水印、视频切片(m3u8、ts)、视频录制、视频推流、更改音视频参数（编码方式、分辨率、码率、比特率等）功能，等等...

下载下来解压完了呢是这个样子：

bin中文件夹有个 ffmpeg.exe，点开，是的，一闪而逝并没有什么用，因为ffmpeg靠命令行来调用：

如上图命令读取 《小星星》.mp4 文件的文件信息，下面的一大片输出就是文件的信息输出了。

2、Java调用FFmpeg

现在我们需要把目标视频在第10秒处截图，怎么做呢，先看看用命令行是这样：

C:\workspace\project\greejoy\picManager\web\tools\ffmpeg\bin\ffmpeg.exe -i C:\Users\Dulk\Desktop\ukulele\01\《小星星》.mp4 -f image2 -ss 10 -t 0.001 -s 320*240 C:\Users\Dulk\Desktop\ukulele\01\littleStar.jpg

1

 

1

C:\workspace\project\greejoy\picManager\web\tools\ffmpeg\bin\ffmpeg.exe -i C:\Users\Dulk\Desktop\ukulele\01\《小星星》.mp4 -f image2 -ss 10 -t 0.001 -s 320*240 C:\Users\Dulk\Desktop\ukulele\01\littleStar.jpg

其中：

• C:\workspace\project\greejoy\picManager\web\tools\ffmpeg\bin\ffmpeg.exe 指 ffmpeg.exe 的路径
• C:\Users\Dulk\Desktop\ukulele\01\《小星星》.mp4 指源视频路径
• C:\Users\Dulk\Desktop\ukulele\01\littleStar.jpg 指截图的输出路径
• -i 表示输入文件的命令
• -f 表示输出格式，image2表示输出为图片
• -ss 表示指定的起始位置，这里设置为10，即10s处
• -t 表示设置录制/转码时长，既然截图就0.001就足够了
• -s 表示size，设置帧大小

（更多的 ffmpeg命令行参数详解）

现在我们看看用Java调用FFmpeg来实现相同的目的，要用到 ProcessBuilder 这个类，该类用于创建操作系统进程，执行本地命令或脚本等工作，其属性command是一个字符串列表（用以输入命令），然后通过start()方法启动执行，但需要注意的是，该方法调用会启动新的进程执行操作，所以并不是和原Java代码同步执行的。

public class FFmpegTest {

    public static void main(String[] args) {

        String ffmpegExePath = "C:\\workspace\\project\\greejoy\\picManager\\web\\tools\\ffmpeg\\bin\\ffmpeg.exe";
        String inputFilePath = "C:\\Users\\Dulk\\Desktop\\ukulele\\01\\《小星星》.mp4";
        String outputFilePath = "C:\\Users\\Dulk\\Desktop\\ukulele\\01\\littleStarJava.jpg";

        List<String> command = new ArrayList<String>();
        command.add(ffmpegExePath);
        command.add("-i");
        command.add(inputFilePath);
        command.add("-f");
        command.add("image2");
        command.add("-ss");
        command.add("10");
        command.add("-t");
        command.add("0.001");
        command.add("-s");
        command.add("320*240");
        command.add(outputFilePath);

        ProcessBuilder builder = new ProcessBuilder();
        builder.command(command);
        //正常信息和错误信息合并输出
        builder.redirectErrorStream(true);
        try {
            //开始执行命令
            Process process = builder.start();

            //如果你想获取到执行完后的信息，那么下面的代码也是需要的
            StringBuffer sbf = new StringBuffer();
            String line = null;
            BufferedReader br = new BufferedReader(new InputStreamReader(process.getInputStream()));
            while ((line = br.readLine()) != null) {
                sbf.append(line);
                sbf.append(" ");
            }
            String resultInfo = sbf.toString();
            System.out.println(resultInfo);

        } catch (IOException e) {
            e.printStackTrace();
        }
    }

}

47

 

1

public class FFmpegTest {

2

3

    public static void main(String[] args) {

4

5

        String ffmpegExePath = "C:\\workspace\\project\\greejoy\\picManager\\web\\tools\\ffmpeg\\bin\\ffmpeg.exe";

6

        String inputFilePath = "C:\\Users\\Dulk\\Desktop\\ukulele\\01\\《小星星》.mp4";

7

        String outputFilePath = "C:\\Users\\Dulk\\Desktop\\ukulele\\01\\littleStarJava.jpg";

8

9

        List<String> command = new ArrayList<String>();

10

        command.add(ffmpegExePath);

11

        command.add("-i");

12

        command.add(inputFilePath);

13

        command.add("-f");

14

        command.add("image2");

15

        command.add("-ss");

16

        command.add("10");

17

        command.add("-t");

18

        command.add("0.001");

19

        command.add("-s");

20

        command.add("320*240");

21

        command.add(outputFilePath);

22

23

        ProcessBuilder builder = new ProcessBuilder();

24

        builder.command(command);

25

        //正常信息和错误信息合并输出

26

        builder.redirectErrorStream(true);

27

        try {

28

            //开始执行命令

29

            Process process = builder.start();

30

31

            //如果你想获取到执行完后的信息，那么下面的代码也是需要的

32

            StringBuffer sbf = new StringBuffer();

33

            String line = null;

34

            BufferedReader br = new BufferedReader(new InputStreamReader(process.getInputStream()));

35

            while ((line = br.readLine()) != null) {

36

                sbf.append(line);

37

                sbf.append(" ");

38

            }

39

            String resultInfo = sbf.toString();

40

            System.out.println(resultInfo);

41

42

        } catch (IOException e) {

43

            e.printStackTrace();

44

        }

45

    }

46

47

}

可以看到，拼接命令实际上就是把参数和值按序传入一个List，然后将该List传给 ProcessBuilder 类，然后执行 start() 方法即可。可以看到控制台输出的信息如下：

需要注意的是：

• 操作执行信息的读取是分为正常信息和错误信息，分别需要使用 getInputStream() 和 getErrorStream() 读取，上例使用了 builder.redirectErrorStream(true); 将两者合并输出
• 如果要使用 Process.waitFor() 则需要小心阻塞问题，此处不展开（FFmpeg在JAVA中的使用以及Process.waitFor()引发的阻塞问题）

3、Builder设计模式的应用

如果你每次使用都要如上例中add()一大堆参数，我估计也是头疼：

List<String> command = new ArrayList<String>();
command.add(ffmpegExePath);
command.add("-i");
command.add(inputFilePath);
command.add("-f");
command.add("image2");
command.add("-ss");
command.add("10");
command.add("-t");
command.add("0.001");
command.add("-s");
command.add("320*240");
command.add(outputFilePath);

13

 

1

List<String> command = new ArrayList<String>();

2

command.add(ffmpegExePath);

3

command.add("-i");

4

command.add(inputFilePath);

5

command.add("-f");

6

command.add("image2");

7

command.add("-ss");

8

command.add("10");

9

command.add("-t");

10

command.add("0.001");

11

command.add("-s");

12

command.add("320*240");

13

command.add(outputFilePath);

后来一想，这简直就是绝佳的使用builder模式的示例，先把命令封装成一个类：

/**
 * FFmpeg命令的封装类
 */
public class FFmpegCommand {

    private List<String> command;

    public FFmpegCommand(List<String> command) {
        this.command = command == null ? new ArrayList<String>() : command;
    }

    public List<String> getCommand() {
        return command;
    }

    public void setCommand(List<String> command) {
        this.command = command;
    }

    /**
     * 开始执行命令
     *
     * @param callback 回调
     * @return 命令的信息输出
     * @throws FFmpegCommandException
     */
    public String start(FFmpegCallback callback) throws FFmpegCommandException {
        BufferedReader br = null;
        StringBuffer sbf = new StringBuffer();
        String resultInfo = null;
        try {
            ProcessBuilder builder = new ProcessBuilder();
            builder.command(command);
            //正常信息和错误信息合并输出
            builder.redirectErrorStream(true);
            //开启执行子线程
            Process process = builder.start();

            String line = null;
            br = new BufferedReader(new InputStreamReader(process.getInputStream()));
            while ((line = br.readLine()) != null) {
                sbf.append(line);
                sbf.append(" ");
            }
            resultInfo = sbf.toString();

            //等待命令子线程执行完成
            int exitValue = process.waitFor();
            //完成后执行回调
            if (exitValue == 0 && callback != null) {
                callback.complete(resultInfo);
            }
            //销毁子线程
            process.destroy();

        } catch (IOException e) {
            e.printStackTrace();
            throw new FFmpegCommandException(e.getMessage());
        } catch (InterruptedException e) {
            e.printStackTrace();
            throw new FFmpegCommandException("线程阻塞异常:" + e.getMessage());
        } finally {
            try {
                if (br != null) {
                    br.close();
                }
            } catch (IOException e) {
                e.printStackTrace();
            }
        }

        return resultInfo;
    }

}

75

 

1

/**

2

 * FFmpeg命令的封装类

3

 */

4

public class FFmpegCommand {

5

6

    private List<String> command;

7

8

    public FFmpegCommand(List<String> command) {

9

        this.command = command == null ? new ArrayList<String>() : command;

10

    }

11

12

    public List<String> getCommand() {

13

        return command;

14

    }

15

16

    public void setCommand(List<String> command) {

17

        this.command = command;

18

    }

19

20

    /**

21

     * 开始执行命令

22

     *

23

     * @param callback 回调

24

     * @return 命令的信息输出

25

     * @throws FFmpegCommandException

26

     */

27

    public String start(FFmpegCallback callback) throws FFmpegCommandException {

28

        BufferedReader br = null;

29

        StringBuffer sbf = new StringBuffer();

30

        String resultInfo = null;

31

        try {

32

            ProcessBuilder builder = new ProcessBuilder();

33

            builder.command(command);

34

            //正常信息和错误信息合并输出

35

            builder.redirectErrorStream(true);

36

            //开启执行子线程

37

            Process process = builder.start();

38

39

            String line = null;

40

            br = new BufferedReader(new InputStreamReader(process.getInputStream()));

41

            while ((line = br.readLine()) != null) {

42

                sbf.append(line);

43

                sbf.append(" ");

44

            }

45

            resultInfo = sbf.toString();

46

47

            //等待命令子线程执行完成

48

            int exitValue = process.waitFor();

49

            //完成后执行回调

50

            if (exitValue == 0 && callback != null) {

51

                callback.complete(resultInfo);

52

            }

53

            //销毁子线程

54

            process.destroy();

55

56

        } catch (IOException e) {

57

            e.printStackTrace();

58

            throw new FFmpegCommandException(e.getMessage());

59

        } catch (InterruptedException e) {

60

            e.printStackTrace();

61

            throw new FFmpegCommandException("线程阻塞异常:" + e.getMessage());

62

        } finally {

63

            try {

64

                if (br != null) {

65

                    br.close();

66

                }

67

            } catch (IOException e) {

68

                e.printStackTrace();

69

            }

70

        }

71

72

        return resultInfo;

73

    }

74

75

}

自然，要有builder类：

public class FFmpegCommandBuilder {

    List<String> command = new ArrayList<String>();

    public FFmpegCommandBuilder(String exePath) {
        if (exePath == null) {
            throw new FFmpegCommandRuntimeException("ffmpeg.exe 路径不得为空");
        }
        //添加命令的exe执行文件位置
        command.add(exePath);
    }

    /**
     * 添加输入文件的路径
     *
     * @param inputFilePath
     */
    public FFmpegCommandBuilder input(String inputFilePath) {
        if (inputFilePath != null) {
            command.add("-i");
            command.add(inputFilePath);
        }
        return this;
    }

    /**
     * 添加输出文件的路径
     *
     * @param outputFilePath
     */
    public FFmpegCommandBuilder output(String outputFilePath) {
        if (outputFilePath != null) {
            command.add(outputFilePath);
        }
        return this;
    }

    /**
     * 覆盖输出文件
     */
    public FFmpegCommandBuilder override() {
        command.add("-y");
        return this;
    }

    /**
     * 强制输出格式
     *
     * @param format 输出格式
     */
    public FFmpegCommandBuilder format(FFmpegCommandFormatEnum format) {
        if (format != null) {
            command.add("-f");
            command.add(format.getValue());
        }
        return this;
    }

    /**
     * 设置录制/转码的时长
     *
     * @param duration 形如 0.001 表示0.001秒，hh:mm:ss[.xxx]格式的记录时间也支持
     */
    public FFmpegCommandBuilder duration(String duration) {
        if (duration != null) {
            command.add("-t");
            command.add(duration);
        }
        return this;
    }

    /**
     * 搜索到指定的起始时间
     *
     * @param position 形如 17 表示17秒，[-]hh:mm:ss[.xxx]的格式也支持
     */
    public FFmpegCommandBuilder position(String position) {
        if (position != null) {
            command.add("-ss");
            command.add(position);
        }
        return this;
    }

    /**
     * 设置帧大小
     *
     * @param size 形如 xxx*xxx
     * @return
     */
    public FFmpegCommandBuilder size(String size) {
        if (size != null) {
            command.add("-s");
            command.add(size);
        }
        return this;
    }

    /**
     * 创建FFmpegCommand命令封装类
     *
     * @return FFmpegCommand
     */
    public FFmpegCommand build() {
        return new FFmpegCommand(command);
    }

}

108

 

1

public class FFmpegCommandBuilder {

2

3

    List<String> command = new ArrayList<String>();

4

5

    public FFmpegCommandBuilder(String exePath) {

6

        if (exePath == null) {

7

            throw new FFmpegCommandRuntimeException("ffmpeg.exe 路径不得为空");

8

        }

9

        //添加命令的exe执行文件位置

10

        command.add(exePath);

11

    }

12

13

    /**

14

     * 添加输入文件的路径

15

     *

16

     * @param inputFilePath

17

     */

18

    public FFmpegCommandBuilder input(String inputFilePath) {

19

        if (inputFilePath != null) {

20

            command.add("-i");

21

            command.add(inputFilePath);

22

        }

23

        return this;

24

    }

25

26

    /**

27

     * 添加输出文件的路径

28

     *

29

     * @param outputFilePath

30

     */

31

    public FFmpegCommandBuilder output(String outputFilePath) {

32

        if (outputFilePath != null) {

33

            command.add(outputFilePath);

34

        }

35

        return this;

36

    }

37

38

    /**

39

     * 覆盖输出文件

40

     */

41

    public FFmpegCommandBuilder override() {

42

        command.add("-y");

43

        return this;

44

    }

45

46

    /**

47

     * 强制输出格式

48

     *

49

     * @param format 输出格式

50

     */

51

    public FFmpegCommandBuilder format(FFmpegCommandFormatEnum format) {

52

        if (format != null) {

53

            command.add("-f");

54

            command.add(format.getValue());

55

        }

56

        return this;

57

    }

58

59

    /**

60

     * 设置录制/转码的时长

61

     *

62

     * @param duration 形如 0.001 表示0.001秒，hh:mm:ss[.xxx]格式的记录时间也支持

63

     */

64

    public FFmpegCommandBuilder duration(String duration) {

65

        if (duration != null) {

66

            command.add("-t");

67

            command.add(duration);

68

        }

69

        return this;

70

    }

71

72

    /**

73

     * 搜索到指定的起始时间

74

     *

75

     * @param position 形如 17 表示17秒，[-]hh:mm:ss[.xxx]的格式也支持

76

     */

77

    public FFmpegCommandBuilder position(String position) {

78

        if (position != null) {

79

            command.add("-ss");

80

            command.add(position);

81

        }

82

        return this;

83

    }

84

85

    /**

86

     * 设置帧大小

87

     *

88

     * @param size 形如 xxx*xxx

89

     * @return

90

     */

91

    public FFmpegCommandBuilder size(String size) {

92

        if (size != null) {

93

            command.add("-s");

94

            command.add(size);

95

        }

96

        return this;

97

    }

98

99

    /**

100

     * 创建FFmpegCommand命令封装类

101

     *

102

     * @return FFmpegCommand

103

     */

104

    public FFmpegCommand build() {

105

        return new FFmpegCommand(command);

106

    }

107

108

}

那么使用builder模式，还是刚才的目的，我们的代码就变成了：

public class FFmpegBuilderTest {

    public static void main(String[] args) {

        String ffmpegExePath = "C:\\workspace\\project\\greejoy\\picManager\\web\\tools\\ffmpeg\\bin\\ffmpeg.exe";
        String inputFilePath = "C:\\Users\\Dulk\\Desktop\\ukulele\\01\\《小星星》.mp4";
        String outputFilePath = "C:\\Users\\Dulk\\Desktop\\ukulele\\01\\littleStarJavaBuilder.jpg";

        FFmpegCommandBuilder builder = new FFmpegCommandBuilder(ffmpegExePath);
        builder.input(inputFilePath).format(FFmpegCommandFormatEnum.IMAGE)
               .position("10").duration("0.001").size("320*240").output(outputFilePath);
        FFmpegCommand command = builder.build();
        try {
            String result = command.start(null);
            System.out.println(result);
        } catch (FFmpegCommandException e) {
            e.printStackTrace();
        }
    }

}

x

 

1

public class FFmpegBuilderTest {

2

3

    public static void main(String[] args) {

4

5

        String ffmpegExePath = "C:\\workspace\\project\\greejoy\\picManager\\web\\tools\\ffmpeg\\bin\\ffmpeg.exe";

6

        String inputFilePath = "C:\\Users\\Dulk\\Desktop\\ukulele\\01\\《小星星》.mp4";

7

        String outputFilePath = "C:\\Users\\Dulk\\Desktop\\ukulele\\01\\littleStarJavaBuilder.jpg";

8

9

        FFmpegCommandBuilder builder = new FFmpegCommandBuilder(ffmpegExePath);

10

        builder.input(inputFilePath).format(FFmpegCommandFormatEnum.IMAGE)

11

               .position("10").duration("0.001").size("320*240").output(outputFilePath);

12

        FFmpegCommand command = builder.build();

13

        try {

14

            String result = command.start(null);

15

            System.out.println(result);

16

        } catch (FFmpegCommandException e) {

17

            e.printStackTrace();

18

        }

19

    }

20

21

}