Audio/Video Player
当前项目仅能在Linux内核平台上运行
本项目是基于 FFmpeg C api 的简单音视频播放器
项目依赖:
- FFmpeg
- SDL3
./AudeoPlayer <file/directory> [<file/directory> ...] # 单文件/目录或播放列表,循环播放
./AudeoPlayer <file/directory> [<file/directory> ...] --no-window # 不创建窗口,只播放音频播放列表循环播放,当前文件结束后自动切换到下一首;
单个文件打开失败时会打印[ERROR] 并跳到下一首,若一轮全部失败则退出。
窗口模式:
| 按键 | 功能 |
|---|---|
Space |
暂停 / 继续 |
N / P |
下一首 / 上一首 |
↑ / ↓ 或 + / - |
音量 +5% / -5% |
→ / ← |
快进 / 快退 5 秒 |
Q / Esc |
退出 |
--no-window 模式(终端按键):
| 按键 | 功能 |
|---|---|
Space |
暂停 / 继续 |
N / P |
下一首 / 上一首 |
+ / - |
音量 +5% / -5% |
. / , |
快进 / 快退 5 秒 |
Q |
退出 |
说明:
--no-window下不创建窗口、不初始化视频输出,视频数据会被丢弃;仅有视频流的 文件会报错并跳过。- 没有播放窗口时(
--no-window或纯音频文件)使用终端按键控制。 - 终端不是 TTY 时无法读取按键,但仍会按播放列表自动连播。
基础组件测试位于 tests/,使用 CTest 运行:
cmake -S . -B build -DCMAKE_BUILD_TYPE=Debug
cmake --build build -j$(nproc)
ctest --test-dir build --output-on-failure覆盖 PCM 环形缓冲、数据包队列、视频帧队列、音频/系统时钟、媒体时间线和应用事件,
不需要音频/视频设备或媒体素材。配置时传入 -DBUILD_TESTING=OFF 可关闭测试构建。
- 目前使用
SDL_Log作为日志输出
[x] 搭建SDL3窗口
[x] 音频解码
[x] 播放音频
[x] 事件驱动主循环
[x] 播放视频
[x] 音视频同步(音频主时钟)
[x] video-only 播放(使用系统时钟作为主时钟)
[x] 播放列表(直接在 cli 中传入多条路径)
[x] 下一/上一文件
[x] 暂停 / 音量
[x] seek(固定 5 秒步长)
[x] 终端控制(--no-window)
命名空间 avplayer
-
中间模块
- 多线程
- 流解析
- 拆分为
- 音频流
- 视频流
- 拆分为
- 数据缓冲队列
-
FFmpeg
- 音视频处理
- 解封装
- 解码
- 原始PCM
- 编码
- 封装
- 音视频处理
-
SDL3
- 创建窗口
- 播放模块
- Audio
- Video
- 音频输出
- 视频渲染
- 音频同步
- 基础设施
- 线程类型
- 线程安全的阻塞队列
- 线程安全的环形帧队列
- 时钟
- 媒体层
- 解封装
- 音频解码
- 视频解码
- 重采样
- 输出层
- 窗口
- 音视频输出
- 固定5线程
- 主线程
- 解封装
- 音频解码
- 视频解码
- 同步层
- 音视频同步时钟