基于 FFmpeg 音视频处理全套工程案例合集

基于FFmpeg音视频处理全套工程案例合集⚠️重要前置说明：两种开发模式命令行模式：启动子进程调用ffmpeg.exe/ffmpeg，开发简单，适合业务工具、中小型系统；原生API模式（libav）：编译链接libavformat/libavcodec/libavutil/libswscale，无进程开销，高性能服务（直播网关、转码集群）。环境：预先安装FFmpeg并配置环境变量，或内置二进制文件。目录【案例1】Python批量音视频工具箱（ffmpeg-python，快速落地）【案例2】JavaSpringBoot分布式视频转码系统（Web服务，后台任务）【案例3】Go轻量直播推流&拉流录制工具【案例4】C++FFmpeg原生API工程（解封装、编码、音视频合成，核心底层）【案例5】常用FFmpeg核心命令清单（配套所有项目直接调用）部署建议、集群转码优化方案案例1：Pythonffmpeg-python全能批量处理工具适合：本地批量处理、小工具、自动化脚本依赖安装bashpipinstallffmpeg-python#系统提前装好ffmpeg完整源码av_tool.pypython运行importffmpegimportosfrompathlibimportPathclassFFmpegTool:@staticmethoddefvideo_audio_split(video_path:str,out_audio:str):"""音视频分离：提取音频"""(ffmpeg.input(video_path).output(out_audio,vn=None)#vn=novideo.overwrite_output().run())@staticmethoddefmux_av(video_no_audio:str,audio_file:str,out_video:str):"""音视频合成（封装）"""video=ffmpeg.input(video_no_audio)audio=ffmpeg.input(audio_file)(ffmpeg.output(video,audio,out_video,vcodec="copy",acodec="copy").overwrite_output().run())@staticmethoddeftranscode(in_path:str,out_path:str,resolution="1280x720",crf=23):"""视频转码h264"""(ffmpeg.input(in_path).filter("scale",resolution.split("x")[0],resolution.split("x")[1]).output(out_path,vcodec="libx264",crf=crf,preset="medium",acodec="aac").overwrite_output().run())@staticmethoddefadd_watermark(video_in:str,watermark_img:str,video_out:str,x=20,y=20):"""添加图片水印"""(ffmpeg.input(video_in).overlay(x,y).input(watermark_img).output(video_out).overwrite_output().run())@staticmethoddefcapture_snapshot(video_path:str,out_img:str,time_pos="00:00:05"):"""截取视频封面截图"""(ffmpeg.input(video_path,ss=time_pos).filter("scale",640,-1).output(out_img,vframes=1).overwrite_output().run())@staticmethoddefbatch_process(folder:str):"""批量遍历文件夹转码"""p=Path(folder)forfileinp.glob("*.mp4"):out=str(file.with_name(f"trans_{}"))print(f"正在处理{}")FFmpegTool.transcode(str(file),out)if__name__=="__main__":tool=FFmpegTool()#示例：提取音频#tool.video_audio_split("test.mp4","audio.aac")#转码#tool.transcode("test.mp4","720p.mp4")#批量#tool.batch_process("./videos")优点：开发速度极快；缺点：高并发场景进程调度开销大，不建议上万任务集群。案例2：SpringBootJava视频转码Web系统（生产可用工程架构）技术方案：JavaProcessBuilder调用FFmpeg命令+线程池+任务数据库记录状态核心模块任务提交接口（上传视频/传入文件路径）线程池异步执行转码任务状态持久化（待处理/转码中/成功/失败）进度解析（捕获ffmpegstderr日志解析当前进度）核心工具类FFmpegUtil.javajava运行importjava.io.BufferedReader;importjava.io.InputStreamReader;importjava.util.concurrent.ExecutorService;importjava.util.concurrent.Executors;publicclassFFmpegUtil{//转码并发数，根据CPU核心调整privatestaticfinalExecutorServiceTRANSCODE_POOL=Executors.newFixedThreadPool(4);/***异步视频转码*/publicstaticvoidasyncTranscode(Stringsrc,Stringdest,LongtaskId){TRANSCODE_POOL.submit(()->{//ffmpeg命令String[]cmd={"ffmpeg","-y","-i",src,"-vcodec","libx264","-preset","medium","-crf","24","-acodec","aac",dest};ProcessBuilderpb=newProcessBuilder(cmd);pb.redirectErrorStream(true);try{Processprocess=pb.start();//读取输出，解析进度BufferedReaderbr=newBufferedReader(newInputStreamReader(process.getInputStream()));Stringline;while((line=br.readLine())!=null){//解析time=xx.xx获取进度，更新数据库task进度if(line.contains("time=")){//updateTaskProgress(taskId,line);}}intexitCode=process.waitFor();if(exitCode==0){//转码成功updateStatus(taskId,SUCCESS)}else{//失败updateStatus(taskId,FAIL)}}catch(Exceptione){e.printStackTrace();}});}//音视频分离publicstaticStringgetExtractAudioCmd(Stringvideo,StringaudioOut){returnString.format("ffmpeg-y-i%s-vn-acodeccopy%s",video,audioOut);}}配套数据表（Mysql）sqlCREATETABLEvideo_transcode_task(idBIGINTPRIMARYKEYAUTO_INCREMENT,src_pathVARCHAR(512),dest_pathVARCHAR(512),statusTINYINTCOMMENT'0待处理1处理中2成功3失败',progressINT,create_timeDATETIME,finish_timeDATETIME);扩展方案：接入RabbitMQ实现分布式转码集群，多机器消费任务。案例3：Go直播推流&录像工具（RTMP推流+拉流录制）Go适合运维工具、边缘推流网关；调用ffmpeg子进程。go运行packagemainimport( "os/exec")//RTMP本地文件推流到直播服务器funcPushStream(videoFilestring,rtmpUrlstring)error{ args:=[]string{ "-re", "-i",videoFile, "-c:v","copy", "-c:a","copy", "-f","flv", rtmpUrl, } cmd:=exec.Command("ffmpeg",args...) returncmd.Run()}//拉取rtmp流，保存为本地视频funcRecordStream(rtmpUrlstring,savePathstring)error{ args:=[]string{ "-y", "-i",rtmpUrl, "-c","copy", savePath, } cmd:=exec.Command("ffmpeg",args...) returncmd.Run()}funcmain(){ //PushStream("input.mp4","rtmp:///live/stream1") //RecordStream("rtmp:///live/stream1","record.mp4")}直播配套：搭配Nginx-RTMP/SRS流媒体服务器搭建完整直播链路。案例4：C++FFmpeglibav原生API完整工程（最底层，无进程调用）⭐高性能转码服务首选，直接调用FFmpeg底层库，不创建子进程功能演示：avformat打开媒体、解封装音频、视频数据包读取视频缩放swscale重新编码+封装输出音视频合成mux编译环境Windows:MSVC+vcpkg安装ffmpegLinux:aptinstalllibavformat-devlibavcodec-devlibswscale-devlibavutil-dev极简核心示例代码main.cppcpp运行extern"C"{#include<libavformat/avformat.h>#include<libavcodec/avcodec.h>#include<libswscale/swscale.h>#include<libavutil/avutil.h>}#include<iostream>staticvoidlog_error(intret){charerr[AV_ERROR_MAX_STRING_SIZE];av_strerror(ret,err,sizeof(err));std::cerr<<err<<std::endl;}intmain(){av_register_all();AVFormatContext*pFormatCtx=nullptr;intret=avformat_open_input(&pFormatCtx,"input.mp4",nullptr,nullptr);if(ret<0){log_error(ret);return-1;}avformat_find_stream_info(pFormatCtx,nullptr);//打印媒体信息av_dump_format(pFormatCtx,0,"input.mp4",0);//后续：查找视频流、打开解码器、读取AVPacket、像素转换、编码、封装输出avformat_close_input(&pFormatCtx);return0;}【重要】完整工程CMakeLists、完整转码代码、pts/dts时间基处理、音频重采样代码量较大，如果你需要，我可以直接输出完整可编译CMake项目整套代码（包含重采样swresample）。C++方案适用场景低延迟实时转码多路并发转码服务器嵌入式设备（ARM网关、摄像头设备）通用高频FFmpeg命令（所有项目直接调用）1.音视频分离bash#提取音频ffmpeg-iinput.mp4-vn-acodeccopyaudio.aac#提取视频（无声）ffmpeg-iinput.mp4-an-vcodeccopysilent.mp42.音视频合成bashffmpeg-isilent.mp4-iaud