编码与格式 / 系统课时

暂停与跳转

暂停与跳转

本课实现播放器最常用的交互控制:暂停、恢复和进度跳转。完成后,你将建立线程安全的控制路径,并在跳转后清空旧数据、刷新解码器和重建播放时钟。

学习目标

  • 设计可被解码、音频和渲染线程共同识别的播放状态
  • 掌握暂停与恢复时的时钟冻结方法
  • 完成一次可靠的跳转与缓冲区重置流程

建立统一控制状态

暂停和跳转不能只修改界面按钮。播放器至少包含读取线程、音频解码线程、视频解码线程、音频设备回调和视频渲染线程,控制命令必须由共享状态传递,并通过互斥锁、条件变量或原子变量保证可见性。

建议把命令与执行结果分开:界面线程只提交 pauseRequested 或 seekRequested,读取线程在安全位置执行 av_read_pause、av_seek_frame 或 avformat_seek_file。这样可以避免多个线程同时操作 AVFormatContext。

暂停与跳转状态及处理链路

实现暂停与恢复

进入暂停状态时,记录当前主时钟值并停止队列消费。线程不要忙等,应在条件变量上休眠;恢复时更新时钟基准并唤醒工作线程。音频设备若支持暂停,应同步暂停设备,否则回调函数需要输出静音且不能继续推进音频时钟。

下面的 C++17 示例演示一个线程安全的暂停控制器。工作线程暂停后不再递增播放位置,恢复后继续运行。

cpp
#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,恢复后工作线程继续推进:

text
paused-position=0
position=1
position=2
position=3

实际播放器还要在暂停瞬间保存主时钟值。恢复时用“保存值 + 恢复后经过的单调时间”继续计算,不能让暂停时长进入播放进度。

执行一次完整跳转

跳转目标通常来自进度条百分比,应先换算为容器时间基。对于以微秒为单位的全局时间轴,可使用 targetUs = seconds * AV_TIME_BASE;对指定流跳转时,则要换算到该流的 time_base。

推荐按以下顺序执行:暂停队列消费;设置新的队列序列号;调用跳转 API;清空音视频包队列和帧队列;对每个解码器调用 avcodec_flush_buffers;清空重采样器、音频设备与渲染器中的旧数据;重置音频、视频和外部时钟;恢复读取并等待新数据建立缓冲。

下面是依赖 FFmpeg 上下文和自定义队列的片段示例,核心是让跳转前后的数据通过序列号隔离。音视频包队列、帧队列、audioOutput_ 和时钟对象由播放器主体提供。

cpp
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 状态。

验收控制功能

暂停后观察音频时钟、视频时钟和界面进度都保持不变;恢复后声音和画面应从原位置连续播放。分别跳转到开头、中间、结尾前几秒,并快速连续拖动,确认没有旧画面闪回、旧声音残留、死锁或队列持续增长。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

暂停与跳转

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通