Skip to content

About

A Simple Audio/Video Player Based On FFmpeg And SDL3

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

83 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AudeoPlayer

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 可关闭测试构建。

TODO

  • 目前使用 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线程
    • 主线程
    • 解封装
    • 音频解码
    • 视频解码
  • 同步层
    • 音视频同步时钟

About

A Simple Audio/Video Player Based On FFmpeg And SDL3

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages