multimedia-utils

介绍

java后端的图片、视频处理工具jar包

1.获取视频信息

2.生成视频封面图

3.异步压缩视频（生成输出文件名后，调用异步压缩视频方法，且同一时间只会处理一个视频，多个请求的视频会进行排队处理）

4.异步压缩视频完成时回调通知

5.图片裁切

6.图片压缩

客户端安装

运行环境需安装FFmpeg和ImageMagick，官网地址如下：

FFmpeg：https://ffmpeg.org/

ImageMagick：http://www.imagemagick.com.cn/

FFmpeg解压后需设置/bin目录的环境变量，ImageMagick安装版安装后会自动设置环境变量。

引入依赖

<dependency>
      <groupId>com.whty.zdxt</groupId>
      <artifactId>multimedia-utils</artifactId>
      <version>0.0.1-SNAPSHOT</version>
</dependency>

配置

yml 配置上传文件的临时路径

spring:
  servlet:
    multipart:
      # 是否支持 multipart 上传文件
      enabled: true
      # 最大支持文件大小
      max-file-size: 10MB
      # 最大支持请求大小
      max-request-size: 10MB
      # 上传文件的临时目录
      location: E:/tomcat-temp

注入视频处理类FFmpegUtils 以及图片处理类 ImageMagickUtils

import com.whty.zdxt.multimedia.util.FFmpegUtils;
import com.whty.zdxt.multimedia.util.ImageMagickUtils;
import org.springframework.context.annotation.Bean;
import org.springframework.stereotype.Component;

@Component
public class MultimediaUtilsConfig {
    
    /**
     * 视频处理工具，因为所有压缩任务需要排队进行，所以FFmpegUtils需要是单例的，FFmpegUtils实例交由spring管理就为单例的
     */
    @Bean
    public FFmpegUtils fFmpegUtilsImpl() {
        return new FFmpegUtils();
    }

    /**
     * 图片处理工具
     */
    @Bean
    public ImageMagickUtils imageMagickUtils() {
        return new ImageMagickUtils();
    }

}

使用

FileController

import com.example.demo.util.FileUtil;
import com.whty.zdxt.multimedia.attribute.CompressionAttributes;
import com.whty.zdxt.multimedia.attribute.CropAttributes;
import com.whty.zdxt.multimedia.attribute.ResizeAttributes;
import com.whty.zdxt.multimedia.attribute.VideoAttributes;
import com.whty.zdxt.multimedia.enumeration.Suffix;
import com.whty.zdxt.multimedia.enumeration.VideoSize;
import com.whty.zdxt.multimedia.pojo.FFmpegInfo;
import com.whty.zdxt.multimedia.util.FFmpegUtils;
import com.whty.zdxt.multimedia.util.ImageMagickUtils;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.autoconfigure.web.servlet.MultipartProperties;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.multipart.MultipartFile;

import java.io.File;

@RestController
@RequestMapping("/file")
public class FileController {

    @Autowired
    private FFmpegUtils fFmpegUtils;

    @Autowired
    private MultipartProperties multipartProperties;

    @Autowired
    private ImageMagickUtils imageMagickUtils;

    /**
     * 获取视频信息
     */
    @PostMapping("/getVideoInfo")
    public Object getFileInfo(@RequestParam MultipartFile file) {
        String location = multipartProperties.getLocation();

        // 生成上传视频的临时文件
        File inputFile = FileUtil.multipartFile2File(file, location);

        // 调用视频处理工具类
        String inputFileName = inputFile.getName();
        FFmpegInfo info = fFmpegUtils.getInfo(location, inputFileName);

        // 删除上传视频的临时文件
        inputFile.delete();
        return info;
    }

    /**
     * 生成视频封面图
     */
    @PostMapping("/createVideoCover")
    public Object createVideoCover(@RequestParam MultipartFile file) {
        String location = multipartProperties.getLocation();
        // 生成上传视频的临时文件
        File inputFile = FileUtil.multipartFile2File(file, location);

        // 调用视频处理工具类
        String outputFileName = fFmpegUtils.createCover(location, inputFile.getName());

        // 删除上传视频的临时文件
        inputFile.delete();
        return outputFileName;
    }

    /**
     * 压缩视频
     */
    @PostMapping("/compressionVideo")
    public Object compressionVideo(@RequestParam MultipartFile file) {

        String location = multipartProperties.getLocation();

        // 生成上传视频的临时文件
        File inputFile = FileUtil.multipartFile2File(file, location);

        // 调用视频处理工具类


        CompressionAttributes compressionAttributes = new CompressionAttributes();
        // 设置视频压缩完成时的回调URL
        compressionAttributes.setProgressUrl("http://localhost:8999/file/callback?fileId=111111&a=456");

        // 设置视频压缩参数
        VideoAttributes videoAttributes = new VideoAttributes();
        videoAttributes.setMaxDuration(15);
        videoAttributes.setMaxFps(20);
        videoAttributes.setVideoSize(VideoSize.HD480);

        compressionAttributes.setVideoAttributes(videoAttributes);

        String outputFileName = fFmpegUtils.putCompressionTask(location, inputFile.getName(), compressionAttributes);

        return outputFileName;
    }

    /**
     * 压缩视频完成时的回调
     */
    @PostMapping("/callback")
    public Object callback(@RequestBody String info, @RequestParam("fileId") String fileId, @RequestParam("a") String a) {
        // 回调信息
        String[] split = info.split("/");

        // 回调参数 fileId，根据fileId查询数据库的上传临时文件名和下载临时文件名，进行文件上传和文件删除
        System.out.println(String.format("fileId为%s的文件已压缩完成", fileId));

        return null;
    }

    /**
     * 图片裁切
     */
    @PostMapping("/crop")
    public Object crop(@RequestParam MultipartFile file) {

        String location = multipartProperties.getLocation();

        // 生成上传图片的临时文件
        File inputFile = FileUtil.multipartFile2File(file, location);

        // 调用图片处理工具类
        // 裁切成3000x1200的图后，修改分辨率为宽800的图（高度按比例缩小）
        CropAttributes cropAttributes = new CropAttributes(3000, 1200, 1000, 500);
        ResizeAttributes resizeAttributes = new ResizeAttributes(800, null);
        String outputFileName = imageMagickUtils.cropAndResize(location, inputFile.getName(), cropAttributes, resizeAttributes);

        // 删除上传图片的临时文件
        inputFile.delete();
        return outputFileName;
    }

    /**
     * 图片分辨率修改
     */
    @PostMapping("/resize")
    public Object resize(@RequestParam MultipartFile file) {

        String location = multipartProperties.getLocation();

        // 生成上传图片的临时文件
        File inputFile = FileUtil.multipartFile2File(file, location);

        // 调用图片处理工具类
        ResizeAttributes resizeAttributes = new ResizeAttributes(800, null);
        String outputFileName = imageMagickUtils.resize(location, inputFile.getName(), resizeAttributes, Suffix.JPG);

        // 删除上传图片的临时文件
        inputFile.delete();
        return outputFileName;
    }

}

FileUtil

import org.springframework.web.multipart.MultipartFile;

import java.io.File;
import java.io.IOException;
import java.util.UUID;

public class FileUtil {

    /**
     * 将上传的MultipartFile转化为File
     */
    public static File multipartFile2File(MultipartFile multipartFile, String directory) {
        String suffix = getSuffix(multipartFile.getOriginalFilename());
        File tempFile = null;
        try {
            tempFile = new File(directory + "/" + UUID.randomUUID().toString() + suffix);
            multipartFile.transferTo(tempFile);
        } catch (IOException e) {
            throw new RuntimeException("multipartFile转File失败", e);
        }
        return tempFile;
    }

    /**
     * 获取文件拓展名
     */
    public static String getSuffix(String fileName) {
        if (fileName == null) {
            throw new RuntimeException("获取文件拓展名失败");
        }
        int index = fileName.lastIndexOf(".");
        if (-1 == index) {
            throw new RuntimeException("获取文件拓展名失败");
        }
        return fileName.substring(index);
    }

}

文档

图片工具ImageMagickUtils

方法

1.图片裁切后修改分辨率并指定输出文件格式

cropAndResize(tempDirectory,inputFileName,cropAttributes,resizeAttributes,outputFileSuffix)

2.图片裁切后修改分辨率

cropAndResize(tempDirectory,inputFileName,cropAttributes,resizeAttributes)

3.图片裁切并指定输出文件格式

crop(tempDirectory,inputFileName,cropAttributes,outputFileSuffix)

4.图片裁切

crop(tempDirectory,inputFileName,cropAttributes)

5.图片修改分辨率并指定输出文件格式

resize(tempDirectory,inputFileName,resizeAttributes,outputFileSuffix)

6.图片修改分辨率

resize(tempDirectory,inputFileName,resizeAttributes)

参数介绍

输入参数

参数	类型	必需	注释
tempDirectory	String	是	临时文件目录
inputFileName	String	是	输入文件名
cropAttributes	CropAttributes	否	裁切参数
resizeAttributes	ResizeAttributes	否	修改分辨率参数
outputFileSuffix	Suffix	否	输出文件格式，未设置则同输入文件格式

其中：

CropAttributes

参数	类型	必需	注释
width	Integer	是	裁切图片的宽
height	Integer	是	裁切图片的高
leftOffset	Integer	是	距左边偏移量
topOffset	Integer	是	距顶部偏移量

ResizeAttributes

参数	类型	必需	注释
width	Integer	否	输出图片的宽，只填写宽则高自适应
height	Integer	否	输出图片的高，只填写高则宽自适应
quality	Integer	否	输出图片的质量，范围0~100，默认100

输出参数

参数	类型	必需	注释
outputFileName	String	是	输出文件名

视频工具FFmpegUtils

方法

1.获取视频信息

getInfo(tempDirectory,inputFileName)

输入参数

参数	类型	必需	注释
tempDirectory	String	是	临时文件目录
inputFileName	String	是	输入文件名

输出参数

参数	类型	必需	注释
format	FFFormat	是	文件信息
videoInfo	VideoInfo	是	视频信息
audioInfo	AudioInfo	是	音频信息

其中：

FFFormat

参数	类型	必需	注释
filename	String	是	文件名全路径名
duration	String	是	文件时长
size	String	是	文件大小
bitRate	String	是	文件比特率

VideoInfo

参数	类型	必需	注释
codecName	String	是	视频编码名称
codecType	String	是	类型 video
width	Integer	是	视频宽度
height	Integer	是	视频高度
frameRate	Integer	是	视频帧率
duration	Integer	是	视频时长
bitRate	Integer	是	视频比特率
nbFrames	Integer	是	视频总帧数

AudioInfo

参数	类型	必需	注释
codecName	String	是	音频编码名称
codecType	String	是	类型 audio
duration	Integer	是	音频时长
bitRate	Integer	是	音频比特率
sampleRate	Integer	是	音频采样率
channels	Integer	是	音频声道数 1：单声道 2：双声道

2.截取视频封面

createCover(tempDirectory, inputFileName, outputFileSuffix)

createCover(tempDirectory, inputFileName)

输入参数

参数	类型	必需	注释
tempDirectory	String	是	临时文件目录
inputFileName	String	是	输入文件名
outputFileSuffix	Suffix	否	输出文件格式，默认jpg

输出参数

参数	类型	必需	注释
outputFileName	String	是	输出文件名

3.视频压缩

putCompressionTask(tempDirectory, inputFileName, compressionAttributes)

putCompressionTask(tempDirectory, inputFileName, compressionAttributes, outputFileName)

输入参数

参数	类型	必需	注释
tempDirectory	String	是	临时文件目录
inputFileName	String	是	输入文件名
compressionAttributes	CompressionAttributes	是	压缩参数
outputFileName	String	否	输出文件名，默认UUID生成

其中：

CompressionAttributes

参数	类型	必需	注释
videoAttributes	VideoAttributes	否	视频压缩参数
audioAttributes	AudioAttributes	否	音频压缩参数
progressUrl	String	是	压缩完成后的回调地址

VideoAttributes

参数	类型	必需	注释
codec	VideoCodec	否	视频编码（默认libx264，libx265）
maxFps	Integer	否	最大帧率
videoSize	VideoSize	否	视频分辨率（hd480，hd720，hd1080，800x800）
maxDuration	Integer	否	最大时长
maxBitRate	Integer	否	视频最大比特率

AudioAttributes

参数	类型	必需	注释
maxBitRate	Integer	否	音频最大比特率
maxSamplingRate	Integer	否	音频最大采样率

输出参数

参数	类型	必需	注释
outputFileName	String	是	输出文件名

nu49121236 / multimedia-utils

multimedia-utils

介绍

客户端安装

引入依赖

配置

yml 配置上传文件的临时路径

注入视频处理类FFmpegUtils 以及图片处理类 ImageMagickUtils

使用

文档

图片工具ImageMagickUtils

方法

1.图片裁切后修改分辨率并指定输出文件格式

2.图片裁切后修改分辨率

3.图片裁切并指定输出文件格式

4.图片裁切

5.图片修改分辨率并指定输出文件格式

6.图片修改分辨率

参数介绍

输入参数

输出参数

视频工具FFmpegUtils

方法

1.获取视频信息

输入参数

输出参数

2.截取视频封面

输入参数

输出参数

3.视频压缩

输入参数

输出参数

简介

发行版

贡献者

近期动态

nu49121236 / multimedia-utils .gitee-modal { width: 500px !important; }

multimedia-utils

介绍

客户端安装

引入依赖

配置

yml 配置上传文件的临时路径

注入 视频处理类FFmpegUtils 以及 图片处理类 ImageMagickUtils

使用

文档

图片工具ImageMagickUtils

方法

1.图片裁切后修改分辨率并指定输出文件格式

2.图片裁切后修改分辨率

3.图片裁切并指定输出文件格式

4.图片裁切

5.图片修改分辨率并指定输出文件格式

6.图片修改分辨率

参数介绍

输入参数

输出参数

视频工具FFmpegUtils

方法

1.获取视频信息

输入参数

输出参数

2.截取视频封面

输入参数

输出参数

3.视频压缩

输入参数

输出参数

简介

发行版

贡献者

近期动态

搜索帮助

nu49121236 / multimedia-utils

注入视频处理类FFmpegUtils 以及图片处理类 ImageMagickUtils