编码与格式 / 系统课时
接入直播播放
接入直播播放
本课把本地播放器扩展为直播播放器,重点解决网络输入不连续、首帧等待、缓冲抖动和连接中断。完成后,你将能控制打开与读取超时,并用统一状态机完成卡顿检测和自动重连。
学习目标
- 为 FFmpeg 网络输入配置超时和低延迟选项
- 用缓冲水位区分启动、播放、卡顿和恢复状态
- 实现可停止、有限退避的断线重连流程
从文件输入切换到网络输入
直播流的解码链路与本地文件基本相同,变化集中在输入层。文件读取失败通常意味着 EOF,而网络读取失败可能是暂时超时、服务端断开、DNS 变化或播放器主动停止,因此不能把所有错误都当作播放结束。
打开网络流前应注册中断回调。FFmpeg 在阻塞连接或读包时会周期性调用它;当截止时间已到或用户请求退出时返回非零,底层阻塞操作才会尽快结束。
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 能打断等待。
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 构建。
./build/live_player <STREAM_URL>预期输出
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、握手耗时和启动水位;若延迟持续增加,检查队列是否只有上限却没有丢弃策略;若频繁重连,区分真正断线与单次读包超时,并适当增加连续超时判定次数。