目录

一、基本语法

二、核心功能与常用参数

三、交互快捷键（播放时可用）

四、特点与适用场景

ffplay 是 FFmpeg 工具集中的轻量级媒体播放器，基于 FFmpeg 的核心库（如 libavformat、libavcodec 等）构建，支持播放几乎所有主流音视频格式、流媒体协议及设备输入（如摄像头、麦克风）。它不仅是一个实用的播放器，还常被用于测试音视频文件的兼容性、调试流媒体或快速预览处理效果。

一、基本语法

ffplay [参数] 输入源

• 输入源：可以是本地文件（如 video.mp4）、网络 URL（如 http://example.com/stream.m3u8）、设备（如摄像头 video=Integrated Camera）等。

二、核心功能与常用参数

1. 基础播放控制

• 播放本地文件：

  ffplay video.mp4  # 直接播放视频文件
  ffplay audio.mp3  # 播放音频文件（仅显示音频波形）
  

• 播放网络流（如 HLS、RTMP）：

  ffplay http://example.com/live/stream.m3u8  # HLS 流
  ffplay rtmp://server/live/stream  # RTMP 流
  

2. 播放控制参数

• -volume <数值>：调整音量（默认 100，如 -volume 200 表示音量加倍）。

• -speed <数值>：调整播放速度（如 -speed 0.5 慢速，-speed 2 快速）。

• -loop <次数>：循环播放（-loop 0 表示无限循环）。

• -ss <时间>：从指定时间点开始播放（如 -ss 00:01:30 从 1 分 30 秒开始）。

• -t <时长>：限制播放时长（如 -t 60 仅播放 60 秒）。

3. 视频显示控制

• -vf <滤镜>：应用视频滤镜（与 ffmpeg 滤镜语法一致），例如：

  ffplay -vf "scale=640:480" video.mp4  # 缩放视频到 640x480
  ffplay -vf "rotate=PI/4" video.mp4    # 旋转视频 45 度（π/4 弧度）
  

• -fs：全屏播放（按 f 键也可切换全屏）。

• -noborder：无边框窗口播放。

4. 音频相关参数

• -af <滤镜>：应用音频滤镜，例如：

  ffplay -af "atempo=0.8" audio.mp3  # 音频减速（不改变音调）
  ffplay -af "volume=0.5" video.mp4  # 降低音量到 50%
  

• -an：禁用音频（仅播放视频画面）。

• -vn：禁用视频（仅播放音频，窗口显示波形）。

5. 流媒体与设备相关

• 播放摄像头（需指定设备名，不同系统设备名格式不同）：

  # Windows 示例（查看设备列表：ffmpeg -list_devices true -f dshow -i dummy）
  ffplay -f dshow -i video="Integrated Camera"
  
  # Linux 示例（设备路径通常为 /dev/video0）
  ffplay /dev/video0
  

• 播放麦克风音频：

  # Windows 示例
  ffplay -f dshow -i audio="Microphone Array"
  

6. 调试与信息显示

• -v <日志级别>：控制日志输出（如 -v debug 显示详细调试信息， -v quiet 关闭日志）。

• -stats：显示播放统计信息（默认开启，包括比特率、帧率等，按 s 键切换显示）。

• -showmode <模式>：切换显示模式（0 = 视频，1 = 音频波形，2 = 音频频谱，按 w 键切换）。

三、交互快捷键（播放时可用）

• 空格：暂停 / 继续

• q / ESC：退出播放

• f：切换全屏

• w：切换显示模式（视频 / 音频波形 / 频谱）

• s：切换统计信息显示

• 左 / 右箭头：后退 / 前进 10 秒

• 上 / 下箭头：增加 / 减少音量

• 鼠标点击：视频窗口中点击可拖动进度条

四、特点与适用场景

• 轻量高效：无需安装复杂播放器，依赖 FFmpeg 自身解码能力，启动快。

• 兼容性极强：支持 FFmpeg 兼容的所有格式和协议，尤其适合播放冷门格式或流媒体。

• 调试辅助：可快速验证音视频文件是否正常、流媒体是否可播放，或测试滤镜效果（如用 -vf 预览 ffmpeg 处理效果）。

ffplay 虽不如专业播放器（如 VLC）功能丰富，但胜在与 FFmpeg 生态深度集成，是开发者和音视频处理人员的实用工具。