编码与格式 / 系统课时
暂停与跳转
暂停与跳转
本课实现播放器最常用的交互控制:暂停、恢复和进度跳转。完成后,你将建立线程安全的控制路径,并在跳转后清空旧数据、刷新解码器和重建播放时钟。
学习目标
- 设计可被解码、音频和渲染线程共同识别的播放状态
- 掌握暂停与恢复时的时钟冻结方法
- 完成一次可靠的跳转与缓冲区重置流程
建立统一控制状态
暂停和跳转不能只修改界面按钮。播放器至少包含读取线程、音频解码线程、视频解码线程、音频设备回调和视频渲染线程,控制命令必须由共享状态传递,并通过互斥锁、条件变量或原子变量保证可见性。
建议把命令与执行结果分开:界面线程只提交 pauseRequested 或 seekRequested,读取线程在安全位置执行 av_read_pause、av_seek_frame 或 avformat_seek_file。这样可以避免多个线程同时操作 AVFormatContext。

实现暂停与恢复
进入暂停状态时,记录当前主时钟值并停止队列消费。线程不要忙等,应在条件变量上休眠;恢复时更新时钟基准并唤醒工作线程。音频设备若支持暂停,应同步暂停设备,否则回调函数需要输出静音且不能继续推进音频时钟。
下面的 C++17 示例演示一个线程安全的暂停控制器。工作线程暂停后不再递增播放位置,恢复后继续运行。
#include <chrono>
#include <condition_variable>
#include <iostream>
#include <mutex>
#include <thread>
class PauseController {
public:
void setPaused(bool value) {
{
std::lock_guard<std::mutex> lock(mutex_);
paused_ = value;
}
condition_.notify_all();
}
void waitIfPaused() {
std::unique_lock<std::mutex> lock(mutex_);
condition_.wait(lock, [this] { return !paused_; });
}
private:
std::mutex mutex_;
std::condition_variable condition_;
bool paused_ = false;
};
int main() {
PauseController controller;
int position = 0;
controller.setPaused(true);
std::thread worker([&] {
for (int i = 0; i < 3; ++i) {
controller.waitIfPaused();
++position;
std::cout << "position=" << position << std::endl;
}
});
std::this_thread::sleep_for(std::chrono::milliseconds(20));
std::cout << "paused-position=" << position << std::endl;
controller.setPaused(false);
worker.join();
}预期输出如下;暂停期间位置保持为 0,恢复后工作线程继续推进:
paused-position=0
position=1
position=2
position=3实际播放器还要在暂停瞬间保存主时钟值。恢复时用“保存值 + 恢复后经过的单调时间”继续计算,不能让暂停时长进入播放进度。
执行一次完整跳转
跳转目标通常来自进度条百分比,应先换算为容器时间基。对于以微秒为单位的全局时间轴,可使用 targetUs = seconds * AV_TIME_BASE;对指定流跳转时,则要换算到该流的 time_base。
推荐按以下顺序执行:暂停队列消费;设置新的队列序列号;调用跳转 API;清空音视频包队列和帧队列;对每个解码器调用 avcodec_flush_buffers;清空重采样器、音频设备与渲染器中的旧数据;重置音频、视频和外部时钟;恢复读取并等待新数据建立缓冲。
下面是依赖 FFmpeg 上下文和自定义队列的片段示例,核心是让跳转前后的数据通过序列号隔离。音视频包队列、帧队列、audioOutput_ 和时钟对象由播放器主体提供。
bool Player::seekTo(double seconds) {
const int64_t targetUs =
static_cast<int64_t>(seconds * AV_TIME_BASE);
std::lock_guard<std::mutex> lock(formatMutex_);
seeking_.store(true);
const int result = avformat_seek_file(
formatContext_,
-1,
INT64_MIN,
targetUs,
INT64_MAX,
AVSEEK_FLAG_BACKWARD
);
if (result < 0) {
seeking_.store(false);
return false;
}
const int newSerial = serial_.fetch_add(1) + 1;
audioPacketQueue_.clear();
videoPacketQueue_.clear();
audioFrameQueue_.clear();
videoFrameQueue_.clear();
avcodec_flush_buffers(audioCodecContext_);
avcodec_flush_buffers(videoCodecContext_);
audioOutput_.flush();
audioClock_.reset(seconds, newSerial);
videoClock_.reset(seconds, newSerial);
seeking_.store(false);
controlCondition_.notify_all();
return true;
}生效行为是:跳转成功后,旧序列号的数据即使晚到也会被丢弃;播放进度从目标附近重新建立。验证时在入队、出队和显示位置打印序列号,确认跳转后不再消费旧序列号。
处理跳转边界
av_seek_frame 和 avformat_seek_file 通常落在目标时间之前的关键帧,视频解码后还需丢弃 PTS 小于目标值的帧,直到抵达目标附近。音频也可能从更早的压缩包开始解码,因此应按采样时间裁剪,避免跳转后听到目标前的声音。
连续拖动进度条时不要执行每一个中间位置。界面可只保留最后一次请求,读取线程完成当前跳转后再检查是否有更新目标。跳转失败时保留原播放位置并恢复消费,不能让播放器永久停在 Seeking 状态。
验收控制功能
暂停后观察音频时钟、视频时钟和界面进度都保持不变;恢复后声音和画面应从原位置连续播放。分别跳转到开头、中间、结尾前几秒,并快速连续拖动,确认没有旧画面闪回、旧声音残留、死锁或队列持续增长。