Inside ffplay.c: The Ultimate Function Encyclopedia

入口。解析参数，初始化 SDL，调用 stream_open，进入 event_loop。

分配 VideoState，初始化各类 Queue，创建解复用线程 read_thread。

销毁 VideoState，中断所有正在阻塞的队列，等待所有子线程退出。

根据音视频流索引，调用 avcodec_open2 打开解码器，并启动对应的音/视/字幕解码线程。

关闭指定的解码器，释放对应的 AVCodecContext。

全局退出函数，调用 stream_close 并清理 SDL 资源。

初始化/销毁存放压缩数据包的链表队列 (使用 SDL_Mutex 和 SDL_Cond 保证线程安全)。

生产者推包 / 消费者拿包。如果队列满/空，会在此处阻塞等待条件变量唤醒。

清空队列。在发生 Seek (快进/后退) 时必须调用，防止旧数据污染新时间线。

初始化/销毁存放解码后裸数据 (AVFrame) 的环形数组缓冲 (Ring Buffer)。

查看队头即将播放的帧 / 将读指针向后移动一位（消费掉一帧）。

解码线程拿到新帧后，推入环形数组。若满了则阻塞。

解复用线程。死循环调用 av_read_frame 读取文件，分发到各 Packet 队列。

视频解码线程。从视频 Packet 队列取数据，解码，压入视频 Frame 队列。

音频解码线程。逻辑同上，产出音频 Frame。

字幕解码线程。由于字幕通常是稀疏的，它的队列管理相对简单。

通用解码封装。内部执行 `avcodec_send_packet` 和 `avcodec_receive_frame` 闭环。

初始化和设置时钟结构体 (包含 pts, 现实时间, 播放速度)。

获取某一时钟的当前时间 / 获取被选为主基准的时钟 (默认 Audio) 当前时间。

核心数学逻辑：比较视频时钟与主时钟的 Diff。快了加倍 Delay，慢了设 Delay 为 0。

每当屏幕刷新一帧视频，用该帧的 PTS 更新视频全局时钟，供其他模块参考。

如果以外部系统时钟为基准，根据当前音视频缓冲状态微调时钟速度，防止卡顿。

主线程事件循环。捕获键盘/鼠标操作，并在空闲时调用视频刷新函数。

帧渲染调度器。取出 FrameQueue 队头帧，结合 `compute_target_delay` 判断：时间未到则等待，时间到了则画，严重超时则丢帧 (Drop)。

调用 SDL API，将视频帧或字幕帧的数据上传至显卡 Texture 并呈现在窗口上。

暂停/播放切换。除了修改标志位，还会暂停系统时钟的时间累加。

触发快进/快退。设置 seek_req 标志，解复用线程看到后会调用 `av_seek_frame` 并清空所有队列。

声卡硬件回调。系统需要声音数据时触发，内部通过状态机向缓冲写入数据。

被上述回调调用。从音频 FrameQueue 取数据，如果采样率/格式与硬件要求不符，会调用 SwrContext 重采样。

如果主时钟不是音频，此函数负责计算音频需要丢弃多少样本或插入静音样本以追平主时钟。

打开 SDL 音频设备，配置所需的采样率、通道数和缓冲区大小。