一、FFplay简介

FFplay是FFmpeg项目自带的轻量级多媒体播放器，基于SDL库开发。作为音视频开发者的瑞士军刀，它不仅支持各种格式的媒体播放，还提供了丰富的调试和分析参数，是多媒体开发测试的必备工具。

二、基础播放参数

1. 输入控制

-i <输入文件>            # 指定输入文件/流地址（必须参数）

2. 窗口设置

-x <宽度>               # 强制设置显示窗口宽度
-y <高度>               # 强制设置显示窗口高度

3. 播放控制

-loop <次数>            # 设置循环播放次数（0表示无限循环）
-autorotate             # 自动旋转视频方向

三、高级调试参数

1. 状态显示

-stats                  # 显示实时统计信息（帧率、比特率等）
-debug_ts               # 显示时间戳调试信息

2. 帧处理

-showmode <模式>        # 设置显示模式（0-视频，1-波形，2-频谱）

3. 同步控制

-sync <类型>            # 设置主时钟源（audio/video/external）

四、音视频处理参数

1. 音频处理

-af <滤镜链>            # 设置音频滤镜（例：-af "volume=0.5"）
-autoexit               # 播放完成后自动退出

2. 视频处理

-vf <滤镜链>            # 设置视频滤镜（例：-vf "scale=640:480"）
-pix_fmt <格式>         # 设置像素格式（yuv420p等）

五、网络流处理

-timeout <微秒>         # 设置网络超时时间
-rtsp_transport <协议>  # 指定RTSP传输协议（tcp/udp）

六、开发者专用参数

-generate 0             # 禁用自动生成
-export <参数>          # 导出指定设置参数

七、实用命令示例

1. 基础播放

ffplay -autoexit input.mp4

2. 音频可视化

ffplay -showmode 1 audio.mp3

3. 网络流分析

ffplay -stats -debug_ts rtsp://example.com/stream

4. 滤镜处理演示

ffplay -vf "split=2[in1][in2]; [in1]crop=100:100:0:0[out1]; [in2]edgedetect[out2]" input.mp4

八、注意事项

1. 参数区分大小写
2. 滤镜链需用双引号包裹
3. 网络协议需要FFmpeg编译时包含对应支持

九、总结

掌握这些参数将帮助您：

• 快速验证媒体文件有效性
• 调试音视频同步问题
• 分析媒体流结构
• 测试编解码器性能

建议收藏本文作为FFplay使用速查手册，后续将推出更多FFmpeg工具深度解析教程！

【注】本文基于FFmpeg 6.0版本生成，部分参数可能随版本更新发生变化，建议通过ffplay -h full获取最新帮助信息。