Skip to content

Latest commit

 

History

History
112 lines (91 loc) · 10.1 KB

README.md

File metadata and controls

112 lines (91 loc) · 10.1 KB
Raw

ffmpeg-common

java关于ffmpeg命令实现音频、视频等操作的封装

提供VideoOperation、AudioOperation操作工具类，方便实现对视频、音频等裁剪、合成、视频音频的拼接等一系列操作，方便操作和调用简单，需自定义ffmpeg的路径，因为后续可能出现ffmpeg版本等问题，所以自定义ffmpeg灵活可靠，提供更好的兼容性.

下载ffmpeg的地址： ffmpeg下载

引入方式：

支持通过maven或者直接引入jar包的方式

  • jar包请到maven仓库中下载即可

    maven仓库地址

  • maven构建依赖：

    <dependency>
    <groupId>com.github.chenliang15405</groupId>
    <artifactId>ffmpeg-common</artifactId>
    <version>3.2</version>
</dependency>

1. VideoOperation 说明

视频操作对象，VideoOperation提供了操作视频的多种API

  • 使用示例：

       public void testConverTest() throws IOException {
      // 指定ffmpeg的绝对路径
      String ffmpegEXE = "/server/notes/ffmpeg";
      String inputPath = "/server/notes/test/2222.mp4";
      String outPutPath = "/server/test/1/convert.flv";
      // 创建VideoOperation对象
      VideoOperation ffmpeg = VideoOperation.builder(ffmpegEXE);
      // 将mp4格式转换为flv格式
      Result result = ffmpeg.videoConvert(inputPath, outPutPath);  
      // 返回结果为0表示正确
      Assert.assertEquals(0, result.getCode());
      // 转换的信息
      System.out.println(result.getErrMessage());  
   }

  • VideoOperation API列表及说明：

    API 参数说明 方法说明
    videoConvert(String inputVideo, String outputVideo) inputVideo 原始视频绝对路径（带视频名称）(xxx/1.mp4)
    outputVideo 输出视频绝对路径（带视频名称）(xxx/1.flv)    		 转换视频格式
    mergeVideoAndBgmWithOrigin(String bgm, String inputVideo, String outputVideo, double seconds) bgm: 背景音乐路径
    inputVideo: 输入音频路径
    outputVideo: 输出视频路径
    seconds: 输出视频秒数    		 保留视频原声并增加背景音乐
    getVideoCoverImg(String inputVideo, String coverOut) inputVideo: 原始视频绝对路径
    coverOut: 图片输出路径    		 获取视频的封面图
    getVideoCoverImgs(Integer startSeconds, String inputVideo,Integer everySecondImg, Integer seconds,String coverOutPath) startSeconds: 多少秒开始截图
    inputVideo: 需要截图的视频绝对路径
    everySecondImg 每秒截多少张图
    seconds: 一共持续截图多少秒
    seconds 一共持续截图多少秒
    coverOutPath 截图生成的路径（图片名称会以001 002... 命名）    		 对视频的指定秒开始截图，可截多张图
    wipeAudio(String inputVideo, String outputVideo) inputVideo: 输入视频绝对路径
    outputVideo: 输出视频绝对路径    		 去除视频的音频
    videoScale(String inputVideo, String outWidth, String outHeight, String outputVideo) inputVideo: 需要操作的原始视频绝对路径
    outWidth: 处理之后的视频的宽度
    outHeight: 处理之后的视频高度
    outputVideo: 处理之后生成的新的视频绝对路径    		 视频缩放
    videoCrop(String inputVideo, String outWidth, String outHeight, String x, String y, String outputVideo) inputVideo: 需要操作的原始视频绝对路径
    outWidth: 处理之后的视频的宽度
    outHeight: 处理之后的视频高度
    outputVideo: 处理之后生成的新的视频绝对路径    		 视频的页面长宽进行裁剪
    videoRotate(String inputVideo, Integer angleNum, String outWidth, String outHeight, String outputVideo) inputVideo: 需要操作的原始视频绝对路径
    angleNum: 旋转的角度，1：180度 2：90度
    outWidth 输出视频的宽度，如果不指定，默认是输入视频的宽度
    outHeight: 输出视频的高度，如果不指定，默认是输入视频的高度
    outputVideo: 处理之后生成的新的视频绝对路径    		 视频角度旋转
    videoFps(String inputVideo, Integer fps, String outputVideo) inputVideo: 需要操作的原始视频绝对路径
    fps: 需要调节到多少帧
    outputVideo: 处理之后生成的新的视频绝对路径    		 调节视频帧数
    gifConvertToVideo(String gif, String outputVideo) gif: gif绝对路径
    outputVideo: 输出视频绝对路径    		 gif转换为video
    videoConvertToGif(String inputVideo, String outputGif, boolean highQuality) inputVideo: 需操作视频的绝对路径
    outputGif: 生成gif的输出绝对路径
    highQuality 是否生成高质量gif    		 视频转gif
    videoCut(String inputVideo,String startTime, String seconds, String outputVideo) inputVideo: 原始需要操作视频的绝对路径
    startTime 开始裁剪的时间 支持格式： 2 或 00:00:02 从2秒开始
    seconds 剪裁持续的时间 支持格式： 3 或 00:00:03 持续3秒
    outputVideo 输出视频的绝对路径    		 对视频的播放时间进行裁剪
    mergeVideoAndBgmNoOrigin(String videoInputPath, String videoOutPath, String bgmInputPath, double seconds) videoInputPath: 原始视频绝对路径
    videoOutPath 处理之后视频输出路径
    bgmInputPath 添加的背景音乐绝对路径
    seconds 输出视频的秒数    		 视频合并音频，给视频加上背景音乐，并不保留视频原声(此方法在Mac平台无效)
    convertorWithBgmNoOriginCommon(String videoInputPath, String videoOutPath, String noSoundVideoPath, String bgmInputPath, double seconds) videoInputPath: 原始视频绝对路径
    videoOutPath: 处理之后视频输出路径
    noSoundVideoPath: 原始视频去除音频的输出绝对路径
    bgmInputPath: 添加的背景音乐绝对路径
    seconds: 输出视频的秒数    		 视频合并音频，给视频加上背景音乐，并不保留视频原声，此方法比较通用，并且Mac可以使用
    transformVideoCover(String videoInputPath, String imagePath, String videoOutPath) videoInputPath: 原始视频绝对路径
    imagePath 替换的封面图片绝对路径
    videoOutPath 新的视频输出路径
    		 修改视频封面图片
    mergeMultiOnlineVideos(File videoListFile, String videoOutPath) videoListFile: 绝对路径下的视频list文件（参考sample文件：docs/video-example/video-online-example.txt）
    videoOutPath: 新视频输出路径
    		 合并多个在线视频（ts格式）, 根据文件中在线视频地址顺序合并（（参考sample文件：docs/video-example/video-online-example.txt））
    mergeMultiVideosOfTsOrMpegFormat(List fileNameList, String videoOutPath) fileNameList: 需要合并的视频文件集合，文件名称为绝对路径
    videoOutPath: 视频输出绝对路径    		 合并多个视频文件(此方法只适用ts格式文件,或者mpg/mpeg格式文件)
    mergeMultiVideosByFile(File videoListFile, String videoOutPath) videoListFile: 定义合并视频的文件，按照指定格式访问（文件示例：docs/video-example/video-example.txt）
    videoOutPath: 视频输出绝对路径文件名    		 根据自定义文件中定义视频绝对路径信息，按照顺序合并视频（文件示例：docs/video-example/video-example.txt）
    autoMergeMultiVideosByDir(String dir, String videoOutPath) dir: 视频文件目录绝对路径
    videoOutPath: 视频输出绝对路径    		 根据文件目录，自动合并该目录下所有视频（默认合成的顺序按照文件名称进行排序）

  • 合并视频注意事项

    • 合并的多个视频必须相同的分辨率，否则合成的视频会黑屏

2. AudioOperation 说明

音频操作对象，AudioOperation提供了操作视频的多种API

  • 使用示例：

      public void audioFormatTest() {
     // 指定ffmpeg的绝对路径
     String ffmpegEXE = "/server/notes/ffmpeg";
     String inputPath = "/server/notes/VideoTest/amr.amr";
     String outPutPath = "/server/notes/VideoTest/mp3.mp3";
     // 创建AudioOperation对象
     AudioOperation ffmpeg = AudioOperation.builder(ffmpegEXE);
     // 转换为音频的amr格式为mp3格式
     Result result = ffmpeg.transFormatToMp3Audio(inputPath, outPutPath);
     // 返回结果为0表示转换成功
     Assert.assertEquals(0, result.getCode());
     // 转换的信息
     System.out.println(result.getErrMessage());
  }

  • AudioOperation API列表及说明：

    API 参数说明 方法说明
    audioConcat(String bgmOutPath, String... bgmInputPath) bgmOutPath: 输出音频文件
    bgmInputPath 输入的音频文件, 多值参数    		 将多个音频文件拼接为一个音频文件并输出
    audioCut(String bgmInputPath, String bgmOutPath, String startTime, String endTime) bgmInputPath 音频输入绝对路径
    bgmOutPath 音频输出绝对路径
    startTime: 截取的开始时间(例如：00:00:00)
    endTime: 截取的结束时间(例如：00:06:38)    		 通过指定开始时间和结束时间 裁剪音频
    getBgmFromVideo(String inputVideo, String outAudio) inputVideo：视频绝对路径
    outAudio: 输出音频绝对路径    		 从视频中提取音频
    transFormatAudio(String inputAudio, String outAudio) inputAudio: 输入视频绝对路径
    outAudio: 输出音频绝对路径    		 转换音频格式
    transFormatAmrAudio(String inputAudio, String outAudio) inputAudio: 输入视频/音频绝对路径
    outAudio 输出音频绝对路径    		 将其他格式的音频或视频转成AMR
    transFormatToMp3Audio(String inputAudio, String outAudio) inputAudio 输入视频绝对路径
    outAudio 输出音频绝对路径    		 转换音频格式 mp3编码方式采用的是libmp3lame

3.返回结果说明

  • Result对象
    • code 表示返回的状态码： 0 表示正常
    • errMessage 表示转换的信息： 不用于判断，是ffmpeg的转换过程产生的信息