目录

一、先给结论

二、avformat_seek_file函数原型

三、三个时间戳的真实含义（核心）

参数语义表

播放器拖进度条的标准写法

四、为什么 MKV / WebM 必须 BACKWARD？

如果你不 BACKWARD：

五、avformat_seek_file vs av_seek_frame（灵魂对比）

六、一个你绝对会问的问题：min/max 怎么玩高级？

场景 1：宁可早一点，绝不晚（视频）

场景 2：允许 ±1 秒（减少线性扫）

场景 3：AVSEEK_FLAG_ANY（千万别乱用）

七、完整播放器级 Seek 模板

八、为什么你以前“调用了还是 EOF”？

九、一句话记忆法

十、总结

avformat_seek_file 是 FFmpeg 库中用于在媒体文件里跳转定位的核心函数‌，主要用在播放器进度条拖动、快进快退等场景，能让程序快速找到文件中的指定时间点 。‌‌‌

如果你写过 FFmpeg 播放器，大概率干过这事：

av_seek_frame(fmt_ctx, vidx, ts, AVSEEK_FLAG_BACKWARD);

然后发现：

• MKV 一拖就 EOF

• WebM 直接播完

• 进度条越拖越乱

• StackOverflow 有人说：“用avformat_seek_file啊”

于是你换了函数，但还是懵：

“这俩到底啥区别？参数为什么这么多？min/max 是干嘛的？”

今天这篇，把avformat_seek_file一次说透。

一、先给结论

播放器拖进度条：优先用avformat_seek_file​

av_seek_frame是“底层原语”，不是给 UI 用的

第三个参数min_ts/ 第五个max_ts是 FFmpeg 的“安全气囊”

MKV / WebM / TS 的 seek 稳定性，全靠它撑着

二、avformat_seek_file函数原型

int avformat_seek_file(AVFormatContext *s, int stream_index, int64_t min_ts, int64_t target_ts, int64_t max_ts, int flags);

很多人卡在：为什么我要给三个时间戳？

三、三个时间戳的真实含义（核心）

一句话版本：

“我想跳到 target，但如果找不到，就在 [min, max] 之间随便给我一个合法点”

参数语义表

播放器拖进度条的标准写法

avformat_seek_file(fmt_ctx, vidx, 0, // min target_pts, // 用户想要的点 target_pts, // max = target（先尽量精确） AVSEEK_FLAG_BACKWARD);

意思是：

“尽量跳到target_pts，实在不行往前找最近的 keyframe，别往后跳。”

四、为什么 MKV / WebM 必须 BACKWARD？

Matroska 家族特性：

• 只有Keyframe → Cluster → Timecode

• 没有“帧级索引”

• 你给的target_pts通常落在两个 keyframe 中间

如果你不 BACKWARD：

avformat_seek_file(..., target_pts, target_pts, 0);

结果：

• demuxer 往后找 → 落到下一个 GOP

• 解码器缺参考帧 → 花屏

• 或干脆 cluster 结束 → EOF（你之前踩的那个坑）

BACKWARD 是 Matroska 的生命线

五、avformat_seek_file vs av_seek_frame（灵魂对比）

ffplay / mpv 内部都用avformat_seek_file

六、一个你绝对会问的问题：min/max 怎么玩高级？

场景 1：宁可早一点，绝不晚（视频）

avformat_seek_file(s, vidx, INT64_MIN, target_pts, target_pts, AVSEEK_FLAG_BACKWARD);

FFmpeg 会：

• 往前扫 Cues

• 停在第一个 ≤ target 的 keyframe

场景 2：允许 ±1 秒（减少线性扫）

int64_t off = av_rescale_q(1, {1,1}, vst->time_base); // 1s avformat_seek_file(s, vidx, target_pts - off, target_pts, target_pts + off, AVSEEK_FLAG_BACKWARD);

对无 Cues MKV​ 友好：给 demuxer 一点呼吸空间

场景 3：AVSEEK_FLAG_ANY（千万别乱用）

AVSEEK_FLAG_ANY // ❌ 视频拖进度条禁止

结果：

• B/P 帧直接解码

• 花屏 / 绿边 / 马赛克

✅ 只适合：

• 音频裸流

• 抽帧分析

• 调试工具

七、完整播放器级 Seek 模板

bool player_seek(AVFormatContext* fmt, int vidx, double sec) { AVStream* vst = fmt->streams[vidx]; int64_t target_pts = av_rescale_q((int64_t)(sec * AV_TIME_BASE), AV_TIME_BASE_Q, vst->time_base); int ret = avformat_seek_file(fmt, vidx, 0, target_pts, target_pts, AVSEEK_FLAG_BACKWARD); if (ret < 0) return false; // 解码侧必须做 avcodec_flush_buffers(vctx); avcodec_flush_buffers(actx); packet_queue.clear(); frame_queue.clear(); // 丢到真正目标时间 discard_until_pts(vidx, target_pts); return true; }

八、为什么你以前“调用了还是 EOF”？

99% 是这三件事没齐：

1. 没avcodec_flush_buffers

2. 没清 packet / frame 队列

3. seek 后又被 demux 线程抢读

avformat_seek_file只负责 demuxer 内部位置​

不负责你线程里的世界干净

九、一句话记忆法

avformat_seek_file= “我想去哪 + 允许去哪 + 往前找”​

MKV/WebM = BACKWARD + 视频流 index​

seek 后 = flush + 清队列 + 丢包

十、总结

很多人以为 FFmpeg seek 难，是因为他们拿av_seek_frame当 API 用。

avformat_seek_file才是 FFmpeg 留给“想做播放器的人”的那扇正门。