编码与格式 / 系统课时
播放器模块设计
播放器模块设计
本课把播放器拆成读取、解码、同步、音频输出和视频渲染等独立模块,并确定它们之间的数据方向、线程边界与控制关系。完成设计后,后续实现可以逐个替换模块,而不会把所有逻辑堆进同一个循环。
学习目标
- 划分播放器核心模块及其输入、输出与职责边界
- 设计音视频队列、线程模型和背压策略
- 建立统一状态机与主时钟同步规则
从最小播放能力确定边界
一个最小播放器至少要支持打开媒体、播放、暂停、跳转和停止,并能够连续输出音频、按正确时间显示视频。模块划分应围绕这些行为展开,而不是简单按 FFmpeg API 名称拆类。
读取模块只负责解复用并产生压缩包;音视频解码模块分别消费包并产生原始帧;音频输出模块持续消费音频帧并提供播放时钟;视频渲染模块根据同步结果显示、等待或丢弃视频帧;控制器负责状态转换、线程启停和错误汇总。
组织模块与数据流

模块之间只通过明确的数据对象和线程安全队列连接。读取线程不直接调用渲染器,解码器也不直接控制播放状态,这样才能避免暂停、跳转或关闭时出现交叉依赖。
| 模块 | 主要输入 | 主要输出 | 不负责的事情 |
|---|---|---|---|
| Demuxer | 媒体源、控制命令 | 音视频 AVPacket |
解码和同步 |
| Decoder | 压缩包 | 音频帧或视频帧 | 设备输出 |
| AudioOutput | 音频帧 | 声音、音频时钟 | 视频丢帧决策 |
| SyncController | 视频 PTS、主时钟 | 等待或丢帧建议 | 实际绘制 |
| VideoRenderer | 可显示视频帧 | 画面 | 读取媒体文件 |
设计队列与线程模型
常见实现使用一个读取线程、两个解码线程、一个音频设备回调或输出线程,以及一个视频渲染线程。队列必须有容量上限:队列过大时读取线程等待,队列接近耗尽时继续预读,从而在内存占用和抗抖动能力之间取得平衡。
下面的接口骨架是片段示例,依赖项目中的 PacketQueue、FrameQueue、音频设备和渲染后端,不能独立编译。它用于固定所有权和线程入口,避免模块在实现阶段相互越界。
enum class PlayerState {
Idle,
Opening,
Playing,
Paused,
Seeking,
Stopping,
Error
};
class Player {
public:
bool open(const std::string& url);
void play();
void pause();
void seek(int64_t positionMs);
void stop();
private:
// 控制器统一创建和回收线程,子模块不互相管理生命周期。
void demuxLoop();
void audioDecodeLoop();
void videoDecodeLoop();
void videoRenderLoop();
// 有界队列提供背压,容量应按时长和内存共同评估。
PacketQueue audioPackets_{128};
PacketQueue videoPackets_{128};
FrameQueue audioFrames_{32};
FrameQueue videoFrames_{16};
std::atomic<PlayerState> state_{PlayerState::Idle};
std::atomic<bool> abortRequested_{false};
// seek 后递增序号,旧线程产生的数据可据此丢弃。
std::atomic<uint64_t> serial_{0};
};每个队列元素应携带当前 serial。执行 seek 时先暂停生产,递增序号,清空旧队列,调用解复用器跳转并刷新解码器;恢复后,消费者只接受新序号的数据,防止跳转前的缓存帧再次显示。
选择同步时钟
普通文件播放器通常以音频为主时钟,因为声卡按稳定采样速率播放,频繁拉伸或中断音频比调整视频更容易被察觉。同步控制器计算 videoPts - masterClock:视频领先时等待,轻微落后时立即显示,落后超过阈值时丢帧追赶。
直播或无音频媒体需要备用时钟。可按“音频时钟优先、外部单调时钟次之、视频时钟兜底”的顺序选择,并在暂停、seek 和设备重建时统一重置时钟基准。
管理状态与生命周期

所有公开控制操作都先经过状态校验。例如 pause 只应在 Playing 生效,seek 只允许在已经打开媒体后执行,stop 则应具备幂等性。关闭时先设置中止标志并唤醒全部阻塞队列,再等待线程退出,最后释放解码器、设备和渲染资源。
错误处理也应集中到控制器。任一工作线程遇到不可恢复错误,只上报错误码并请求停止,不直接释放其他线程正在使用的对象,从而避免重复释放和竞态崩溃。
验收设计是否可实现
在开始填充具体解码代码前,可用以下检查项验收设计:
- 每个媒体数据对象只有一个明确的所有者,跨线程传递使用引用计数或移动语义
- 每个阻塞队列都能在停止时被唤醒,不会让
join永久等待 - pause、seek、stop 的状态转换有唯一入口,旧数据能通过序号失效
- 音频时钟、外部时钟和视频时钟的选择规则明确,渲染器不自行修改主时钟
只要这些边界固定,后续即可分别替换解码器、音频后端或渲染后端,而不改变播放器的整体控制流程。