linkedffmpegx/ffmpeg

FFmpeg 镜像文档

镜像概述

FFmpeg是一个功能强大的多媒体处理工具集，包含一系列库和命令行工具，用于处理音频、视频、字幕及相关元数据。它支持多种编解码格式、容器格式和流媒体协议，广泛应用于多媒体内容的转换、编辑、分析和流式传输。

核心功能与特性

核心库

• libavcodec：提供广泛的编解码器实现，支持多种音频和视频编码格式。
• libavformat：实现流媒体协议、容器格式处理及基础I/O访问功能。
• libavutil：包含哈希函数、解压缩器及各类实用工具函数。
• libavfilter：通过过滤器链对解码后的音视频进行处理和修改。
• libavdevice：提供访问音视频采集和播放设备的抽象接口。
• libswresample：实现音频混缩和重采样功能。
• libswscale：提供色彩空间转换和图像缩放功能。

命令行工具

• ffmpeg：命令行工具箱，用于多媒体内容的处理、转换和流式传输。
• ffplay：轻量级多媒体播放器。
• ffprobe：简单的多媒体内容分析工具，用于检查媒体文件信息。
• 其他小型工具：如aviocat（AVI文件连接工具）、ismindex（平滑流式处理工具）和qt-faststart（QuickTime文件优化工具）。

使用场景

• 视频格式转换（如MP4转AVI、FLV转MP3等）
• 音频提取与处理（从视频中提取音频、调整音量、格式转换）
• 流媒体传输（实时推流到RTMP服务器、HLS/DASH切片）
• 视频编辑（裁剪、合并、添加水印、滤镜处理）
• 多媒体文件分析（获取编码信息、时长、比特率等元数据）
• 设备音视频采集（从摄像头、麦克风捕获内容）

使用方法与配置说明

基础使用示例

1. 转换视频格式

将当前目录下的input.mp4转换为output.avi：

bash
docker run -v $(pwd):/data ffmpeg -i /data/input.mp4 /data/output.avi

2. 提取音频

从视频文件中提取MP3音频：

bash
docker run -v $(pwd):/data ffmpeg -i /data/input.mp4 -vn -acodec libmp3lame /data/output.mp3

• -vn：禁用视频流
• -acodec libmp3lame：指定MP3编码器

3. 查看媒体文件信息

使用ffprobe分析文件元数据：

bash
docker run -v $(pwd):/data ffmpeg ffprobe /data/input.mp4

4. 播放媒体文件

使用ffplay播放视频（需宿主机支持图形界面）：

bash
docker run -it --rm -v $(pwd):/data -e DISPLAY=$DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix ffmpeg ffplay /data/input.mp4

常用参数说明

• -i：指定输入文件
• -c:v：视频编码器（如libx264、mpeg4）
• -c:a：音频编码器（如libmp3lame、aac）
• -s：设置视频分辨率（如1280x720）
• -r：设置帧率
• -b:v：视频比特率
• -b:a：音频比特率
• -t：设置处理时长（如00:01:30表示1分30秒）

文档与资源

离线文档

镜像内的doc/目录包含离线文档。

在线文档

• 官方网站：[***]
• 官方Wiki：[***]

示例代码

编码示例位于镜像内的doc/examples目录，包含各类多媒体处理的C语言示例。

许可证

FFmpeg代码库主要采用LGPL许可证，部分可选组件采用GPL许可证。详细信息请参考镜像内的LICENSE文件。

贡献方式

补丁应通过git format-patch或git send-email提交至ffmpeg-devel邮件列表。不建议使用GitHub Pull Request，因其不属于官方审核流程，可能会被忽略。