编码与格式 / 系统课时

接入直播播放

接入直播播放

本课把本地播放器扩展为直播播放器,重点解决网络输入不连续、首帧等待、缓冲抖动和连接中断。完成后,你将能控制打开与读取超时,并用统一状态机完成卡顿检测和自动重连。

学习目标

  • 为 FFmpeg 网络输入配置超时和低延迟选项
  • 用缓冲水位区分启动、播放、卡顿和恢复状态
  • 实现可停止、有限退避的断线重连流程

从文件输入切换到网络输入

直播流的解码链路与本地文件基本相同,变化集中在输入层。文件读取失败通常意味着 EOF,而网络读取失败可能是暂时超时、服务端断开、DNS 变化或播放器主动停止,因此不能把所有错误都当作播放结束。

打开网络流前应注册中断回调。FFmpeg 在阻塞连接或读包时会周期性调用它;当截止时间已到或用户请求退出时返回非零,底层阻塞操作才会尽快结束。

cpp
struct IoControl {
    std::atomic<bool> stopping{false};
    std::atomic<int64_t> deadlineUs{0};
};

static int interruptCallback(void* opaque) {
    auto* control = static_cast<IoControl*>(opaque);
    if (control->stopping.load()) return 1;
    return av_gettime_relative() > control->deadlineUs.load() ? 1 : 0;
}

// 片段示例:调用方负责 avformat_close_input,并检查未被协议识别的选项。
AVFormatContext* openLiveInput(const std::string& url, IoControl& control) {
    AVFormatContext* context = avformat_alloc_context();
    context->interrupt_callback = {interruptCallback, &control};

    AVDictionary* options = nullptr;
    av_dict_set(&options, "rw_timeout", "5000000", 0);
    av_dict_set(&options, "fflags", "nobuffer", 0);
    av_dict_set(&options, "flags", "low_delay", 0);
    if (url.rfind("rtsp://", 0) == 0) {
        av_dict_set(&options, "rtsp_transport", "tcp", 0);
    }

    control.deadlineUs = av_gettime_relative() + 5'000'000;
    if (avformat_open_input(&context, url.c_str(), nullptr, &options) < 0) {
        av_dict_free(&options);
        avformat_free_context(context);
        throw std::runtime_error("open live input failed");
    }
    av_dict_free(&options);
    return context;
}

生效行为是:连接和读包超过 5 秒可被中断,RTSP 默认改用 TCP,输入端尽量减少额外缓存。rw_timeout 等选项是否生效取决于具体协议和 FFmpeg 构建,生产代码应检查剩余字典项并记录未识别配置。

用缓冲水位控制播放

直播缓冲的目标不是越大越好,而是在抗抖动与低延迟之间取平衡。播放器启动后先进入缓冲状态,当音频或视频队列达到启动水位再开始输出;播放中若队列低于最低水位,暂时冻结渲染并重新积累数据。

直播播放器缓冲与重连状态机

水位应按“可播放时长”计算,而不是只看包数量。音频可根据累计采样数换算毫秒,视频可使用队列首尾 PTS 差值。低延迟直播可从约 300~800 毫秒的启动缓冲起步,再根据协议、码率和网络质量调节。

卡顿期间不要让主时钟继续前进,否则恢复后所有视频帧都会被判断为过期。进入卡顿时冻结时钟,恢复播放时以当前音频输出位置重新校准。

实现超时检测与断线恢复

重连必须先彻底停止旧会话:中断阻塞读取、关闭输入上下文、清空包队列、刷新解码器并重置时钟。若直接在旧线程旁再开一条连接,常见后果是重复播放、资源泄漏和旧数据混入新会话。

下面的片段展示有限次数的指数退避。它依赖 playSession 返回会话结束原因,并要求 stopRequested 能打断等待。

cpp
int runLivePlayer(const std::string& url) {
    constexpr int maxAttempts = 6;
    int attempt = 0;

    while (!stopRequested()) {
        const SessionResult result = playSession(url);

        if (result == SessionResult::UserStopped) return 0;
        if (result == SessionResult::FatalConfigError) return 2;

        ++attempt;
        if (attempt > maxAttempts) {
            logError("reconnect attempts exhausted");
            return 3;
        }

        // 1、2、4、8 秒递增,并限制最大等待时间。
        const int delaySeconds = std::min(1 << (attempt - 1), 8);
        logWarn("stream disconnected, retry in {}s", delaySeconds);

        if (!interruptibleSleep(delaySeconds)) return 0;
        resetPacketQueues();
        flushDecoders();
        resetPlaybackClock();
    }
    return 0;
}

当一次会话连续稳定播放一段时间后,应把 attempt 归零,避免短暂故障继承很高的退避级别。对鉴权失败、地址非法等确定性错误则不应盲目重试,应直接上报并等待用户修正配置。

运行与故障演练

使用下面的命令启动直播播放器。<STREAM_URL> 替换为实际 RTMP、RTSP、HTTP-FLV 或 HLS 地址;实际协议支持取决于 FFmpeg 构建。

bash
./build/live_player <STREAM_URL>

预期输出

text
state=CONNECTING url=<STREAM_URL>
state=BUFFERING buffered=<TIME>
state=PLAYING
state=RECONNECT_WAIT attempt=1 delay=1s
state=CONNECTING url=<STREAM_URL>
state=PLAYING

<TIME> 表示实际缓冲时长,日志中的数值会随网络状况变化。验证时先正常播放,再主动停止推流或临时断开网络。播放器应在读取超时后进入重连等待,恢复网络后重新缓冲并继续播放;用户点击停止时,不应继续等待下一次重连。

若首屏时间过长,先检查 DNS、握手耗时和启动水位;若延迟持续增加,检查队列是否只有上限却没有丢弃策略;若频繁重连,区分真正断线与单次读包超时,并适当增加连续超时判定次数。

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

目录与阅读设置

阅读设置

17

记录一个想法

接入直播播放

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

登录哪都通