文章目录
- 1 摘要
- 2 核心 Maven 依赖
- 3 核心代码
- 3.1 FFmpeg 解析音视频工具类
- 3.2 音视频文件信息参数
- 3.3 音视频文件上传Controller
- 3.4 application 配置文件
- 4 测试数据
- 4.1 视频文件解析
- 4.2 音频文件解析
- 5 注意事项
- 5.1 文件必须在本地
- 6 推荐参考文档
- 7 Github 源码
1 摘要
FFmpeg 是最常用的跨平台的音频、视频处理软件,但是其通过命令行的方式进行操作对于普通用户而言上手难度大,同时 FFmpeg 只是函数库,对于不同的编程语言,需要自行适配API接口,以便于操作文件。本文介绍SpringBoot 集成 FFmpeg 实现对音视频文件的解析。
FFmpeg 官网: https://ffmpeg.org
FFmpeg Java 平台常用适配仓库:
JavaCV : https://github.com/bytedeco/javacv
JavaCV 是一个集成第三方函数库的平台,包括 OpenCV、FFmpeg 等知名函数库,提供统一的 API 操作,应用广泛。在不考虑应用程序体积大小的情况下推荐使用 JavaCV 作为集成方案。
JAVE2: https://github.com/a-schild/jave2
JAVE2 是将 FFmpeg 进行封装,并提供 Java API 以供用户操作音视频文件的依赖库。用户可以根据软件运行的操作系统来自由选择所需平台的依赖。
本文是基于 JAVE2 依赖来实现解析音视频文件的功能。
2 核心 Maven 依赖
demo-ffmpeg-media/pom.xml
<!-- ffmpeg 音视频处理 -->
<dependency>
<groupId>ws.schild</groupId>
<artifactId>jave-core</artifactId>
<version>${schild-ffmpeg.version}</version>
</dependency>
<dependency>
<groupId>ws.schild</groupId>
<artifactId>jave-nativebin-win64</artifactId>
<version>${schild-ffmpeg.version}</version>
</dependency>
<dependency>
<groupId>ws.schild</groupId>
<artifactId>jave-nativebin-linux64</artifactId>
<version>${schild-ffmpeg.version}</version>
</dependency>
<dependency>
<groupId>ws.schild</groupId>
<artifactId>jave-nativebin-osx64</artifactId>
<version>${schild-ffmpeg.version}</version>
</dependency>
<dependency>
<groupId>ws.schild</groupId>
<artifactId>jave-nativebin-osxm1</artifactId>
<version>${schild-ffmpeg.version}</version>
</dependency>
其中 schild-ffmpeg
版本为:
<schild-ffmpeg.version>3.5.0</schild-ffmpeg.version>
这里分别引入了 Windows、Linux、macOS 系统的依赖,可根据软件运行环境进行删减。
3 核心代码
3.1 FFmpeg 解析音视频工具类
demo-ffmpeg-media/src/main/java/com/ljq/demo/springboot/ffmpeg/common/util/FFmpegMediaUtil.java
package com.ljq.demo.springboot.ffmpeg.common.util;
import com.ljq.demo.springboot.ffmpeg.model.response.AudioInfoResponse;
import com.ljq.demo.springboot.ffmpeg.model.response.VideoInfoResponse;
import lombok.extern.slf4j.Slf4j;
import org.springframework.util.DigestUtils;
import ws.schild.jave.MultimediaObject;
import ws.schild.jave.info.AudioInfo;
import ws.schild.jave.info.MultimediaInfo;
import ws.schild.jave.info.VideoInfo;
import java.io.File;
import java.nio.file.Files;
import java.util.Objects;
/**
* @Description: FFmpeg 音视频工具类
* @Author: junqiang.lu
* @Date: 2024/5/10
*/
@Slf4j
public class FFmpegMediaUtil {
/**
* 获取视频信息
*
* @param videoPath 视频路径
* @return 视频信息
*/
public static VideoInfoResponse getVideoInfo(String videoPath) {
VideoInfoResponse response = null;
try {
// 解析文件
File videoFile = new File(videoPath);
MultimediaObject multimediaObject = new MultimediaObject(videoFile);
MultimediaInfo multimediaInfo = multimediaObject.getInfo();
VideoInfo videoInfo = multimediaInfo.getVideo();
// 判断是否为视频
if (Objects.isNull(videoInfo) || videoInfo.getBitRate() < 0) {
return null;
}
response = new VideoInfoResponse();
response.setFormat(multimediaInfo.getFormat())
.setDuration(multimediaInfo.getDuration() / 1000)
.setSize(videoFile.length())
.setMd5(DigestUtils.md5DigestAsHex(Files.readAllBytes(videoFile.toPath())));
response.setBitRate(videoInfo.getBitRate())
.setFrameRate(videoInfo.getFrameRate())
.setWidth(videoInfo.getSize().getWidth())
.setHeight(videoInfo.getSize().getHeight());
return response;
} catch (Exception e) {
log.warn("Error processing video file", e);
}
return response;
}
/**
* 获取音频信息
*
* @param audioPath 音频路径
* @return 音频信息
*/
public static AudioInfoResponse getAudioInfo(String audioPath) {
AudioInfoResponse response = null;
try {
// 解析文件
File videoFile = new File(audioPath);
MultimediaObject multimediaObject = new MultimediaObject(videoFile);
MultimediaInfo multimediaInfo = multimediaObject.getInfo();
AudioInfo audioInfo = multimediaInfo.getAudio();
// 判断是否为音频
if (Objects.isNull(audioInfo) || Objects.nonNull(multimediaInfo.getVideo())) {
return null;
}
response = new AudioInfoResponse();
response.setFormat(multimediaInfo.getFormat())
.setDuration(multimediaInfo.getDuration() / 1000)
.setSize(videoFile.length())
.setMd5(DigestUtils.md5DigestAsHex(Files.readAllBytes(videoFile.toPath())));
response.setSamplingRate(audioInfo.getSamplingRate())
.setBitRate(audioInfo.getBitRate())
.setChannels(audioInfo.getChannels())
.setBitDepth(audioInfo.getBitDepth());
return response;
} catch (Exception e) {
log.warn("Error processing audio file", e);
}
return response;
}
}
3.2 音视频文件信息参数
音视频文件公共信息参数
demo-ffmpeg-media/src/main/java/com/ljq/demo/springboot/ffmpeg/model/response/MediaInfoResponse.java
package com.ljq.demo.springboot.ffmpeg.model.response;
import lombok.Data;
import lombok.experimental.Accessors;
import java.io.Serializable;
/**
* @Description: 多媒体信息
* @Author: junqiang.lu
* @Date: 2024/5/10
*/
@Data
@Accessors(chain = true)
public class MediaInfoResponse implements Serializable {
private static final long serialVersionUID = -326368230008457941L;
/**
* 文件格式
*/
private String format;
/**
* 时长,单位:秒
*/
private Long duration;
/**
* 文件大小,单位:字节数
*/
private Long size;
/**
* 文件md5值
*/
private String md5;
}
视频文件参数信息对象
demo-ffmpeg-media/src/main/java/com/ljq/demo/springboot/ffmpeg/model/response/VideoInfoResponse.java
package com.ljq.demo.springboot.ffmpeg.model.response;
import lombok.Data;
import lombok.ToString;
import lombok.experimental.Accessors;
/**
* @Description: 视频文件信息返回对象
* @Author: junqiang.lu
* @Date: 2024/5/10
*/
@Data
@Accessors(chain = true)
@ToString(callSuper = true)
public class VideoInfoResponse extends MediaInfoResponse {
private static final long serialVersionUID = -9016123624628502571L;
/**
* 比特率,单位: bps
*/
private Integer bitRate;
/**
* 帧率,单位: FPS
*/
private Float frameRate;
/**
* 宽度,单位: px
*/
private Integer width;
/**
* 高度,单位: px
*/
private Integer height;
}
音频文件参数信息对象
demo-ffmpeg-media/src/main/java/com/ljq/demo/springboot/ffmpeg/model/response/AudioInfoResponse.java
package com.ljq.demo.springboot.ffmpeg.model.response;
import lombok.Data;
import lombok.ToString;
import lombok.experimental.Accessors;
/**
* @Description: 音频文件信息返回对象
* @Author: junqiang.lu
* @Date: 2024/5/10
*/
@Data
@Accessors(chain = true)
@ToString(callSuper = true)
public class AudioInfoResponse extends MediaInfoResponse {
private static final long serialVersionUID = 3573655613715240188L;
/**
* 采样率
*/
private Integer samplingRate;
/**
* 音频通道数量,1-单声道,2-立体声
*/
private Integer channels;
/**
* 比特率,单位: bps
*/
private Integer bitRate;
/**
* 位深度
*/
private String bitDepth;
}
3.3 音视频文件上传Controller
demo-ffmpeg-media/src/main/java/com/ljq/demo/springboot/ffmpeg/controller/FFmpegMediaController.java
package com.ljq.demo.springboot.ffmpeg.controller;
import com.ljq.demo.springboot.ffmpeg.common.config.UploadConfig;
import com.ljq.demo.springboot.ffmpeg.common.util.FFmpegMediaUtil;
import com.ljq.demo.springboot.ffmpeg.model.response.AudioInfoResponse;
import com.ljq.demo.springboot.ffmpeg.model.response.VideoInfoResponse;
import lombok.extern.slf4j.Slf4j;
import org.springframework.http.MediaType;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.multipart.MultipartFile;
import javax.annotation.Resource;
import java.io.File;
import java.io.IOException;
/**
* @Description: FFmpeg 媒体文件处理控制层
* @Author: junqiang.lu
* @Date: 2024/5/10
*/
@Slf4j
@RestController
@RequestMapping(value = "/api/ffmpeg/media")
public class FFmpegMediaController {
@Resource
private UploadConfig uploadConfig;
/**
* 视频上传
*
* @param file
* @return
* @throws IOException
*/
@PostMapping(value = "/upload/video", produces = {MediaType.APPLICATION_JSON_VALUE})
public ResponseEntity<VideoInfoResponse> uploadVideo(MultipartFile file) throws IOException {
// 文件上传保存
String videoFilePath = uploadConfig.getUploadPath() + File.separator + file.getOriginalFilename();
log.info("videoFilePath: {}", videoFilePath);
File videoFile = new File(videoFilePath);
if (!videoFile.getParentFile().exists()) {
videoFile.getParentFile().mkdirs();
}
file.transferTo(videoFile);
// 获取视频信息
VideoInfoResponse videoInfoResponse = FFmpegMediaUtil.getVideoInfo(videoFilePath);
return ResponseEntity.ok(videoInfoResponse);
}
/**
* 音频上传
*
* @param file
* @return
* @throws IOException
*/
@PostMapping(value = "/upload/audio", produces = {MediaType.APPLICATION_JSON_VALUE})
public ResponseEntity<AudioInfoResponse> uploadAudio(MultipartFile file) throws IOException {
// 文件上传保存
String audioFilePath = uploadConfig.getUploadPath() + File.separator + file.getOriginalFilename();
log.info("audioFilePath: {}", audioFilePath);
File audioFile = new File(audioFilePath);
if (!audioFile.getParentFile().exists()) {
audioFile.getParentFile().mkdirs();
}
file.transferTo(audioFile);
// 获取音频信息
AudioInfoResponse audioInfoResponse = FFmpegMediaUtil.getAudioInfo(audioFilePath);
return ResponseEntity.ok(audioInfoResponse);
}
}
3.4 application 配置文件
# config
server:
port: 9250
# spring
spring:
application:
name: demo-ffmpeg-media
servlet:
multipart:
max-file-size: 1000MB
max-request-size: 1000MB
# uploadConfig
upload:
path: D:\\upload # linux/macOS 路径 /opt/upload
4 测试数据
示例文件下载: https://zh.getsamplefiles.com
4.1 视频文件解析
测试文件:
https://zh.getsamplefiles.com/download/mp4/sample-4.mp4
测试结果:
{
"format": "mov",
"duration": 30,
"size": 7588608,
"md5": "d7b5155ee54ee9c7dcd8cbb5395823dc",
"bitRate": 2015000,
"frameRate": 25.0,
"width": 1280,
"height": 720
}
4.2 音频文件解析
测试文件:
https://zh.getsamplefiles.com/download/mp3/sample-5.mp3
测试结果:
{
"format": "mp3",
"duration": 45,
"size": 1830660,
"md5": "843e2916b1c552fb5e8ee3d83faddb8c",
"samplingRate": 44100,
"channels": 2,
"bitRate": 320000,
"bitDepth": "fltp"
}
5 注意事项
5.1 文件必须在本地
在实际项目中,一般会将文件保存到专门的文件服务器,但是 FFmpeg 解析文件必须是本地文件,因此在上传至文件服务器之前需要将文件在本地服务器做中转,解析完毕后再上传,然后删除本地文件。
6 推荐参考文档
SpringBoot集成ffmpeg实现视频转码播放
Convert video to Another Format in Spring Boot(Java-based apps)
springboot如何获取视频文件的视频时间长度
java 视频识别 java 视频转码
JAVE2 官方 Github
JAVE2 官方文档 Getting informations about a multimedia file
javacv-ffmpeg(八)视频文件信息获取
7 Github 源码
Gtihub 源码地址 : https://github.com/Flying9001/springBootDemo/tree/master/demo-ffmpeg-media
个人公众号:404Code,分享半个互联网人的技术与思考,感兴趣的可以关注.