编码与格式 / 系统课时
录制实时网络流
录制实时网络流
实时网络流可能在录制过程中暂停、断开、返回临时 HTTP 错误或重新开始时间戳。本课以 HTTP/HLS 为主线,配置读取超时和有限重连,将媒体先安全保存为本地 MKV,再验证并按需封装为 MP4。
学习目标
- 使用流复制方式低开销保存实时网络流
- 配置 HTTP/HLS 的超时、断流重连和重试上限
- 识别时间戳异常,并验证录制文件是否连续可用
网络录制链路中的风险
本地文件的长度和时间戳通常已经确定,而实时流会持续产生新数据。录制程序必须同时追踪网络连接、媒体分片、音视频时间戳和本地封装状态;任意一层中断,都可能让进程退出或留下不可播放的文件。

先选择流复制还是转码
| 方式 | 适用情况 | 主要取舍 |
|---|---|---|
-c copy 流复制 |
源编码可直接写入目标容器,时间戳基本正常 | CPU 占用低,但不能修复编码参数或严重时间戳问题 |
| 重新编码 | 源编码不兼容,或重连后持续出现音画漂移 | 可重建输出节奏,但需要更多 CPU,并产生质量损失 |
录制阶段优先写入 Matroska 容器。MKV 在异常中止后通常比普通 MP4 更容易保留已写入的数据;需要发布 MP4 时,可在录制正常结束后再做一次无损封装转换。
HTTP/HLS 断线重连主示例
将 <STREAM_URL> 替换为实际的 HTTP 文件流或 HLS 播放列表地址。rw_timeout 的单位是微秒,示例中的 15000000 表示单次网络读写最多等待约 15 秒。
ffmpeg -hide_banner -y \
-rw_timeout 15000000 \
-reconnect 1 \
-reconnect_at_eof 1 \
-reconnect_streamed 1 \
-reconnect_on_network_error 1 \
-reconnect_on_http_error 429,5xx \
-reconnect_delay_max 10 \
-reconnect_delay_total_max 120 \
-fflags +genpts \
-i "<STREAM_URL>" \
-map 0:v:0 -map "0:a:0?" \
-c copy \
-avoid_negative_ts make_zero \
-f matroska live-record.mkv预期输出
Input #0, hls, from '<STREAM_URL>':
Stream mapping:
Stream #0:<VIDEO_INDEX> -> #0:0 (copy)
Stream #0:<AUDIO_INDEX> -> #0:1 (copy)
Output #0, matroska, to 'live-record.mkv':
frame=<N> fps=<FPS> time=<TIME> speed=<SPEED>网络短暂恢复后,日志通常会再次出现打开分片或重连相关信息,具体文字随协议和版本变化。reconnect_delay_max 10 限制单次退避等待,reconnect_delay_total_max 120 限制累计等待;超过上限后进程退出,而不是永久挂起。
reconnect_on_http_error 429,5xx 只重试限流和服务器临时错误。对 401、403 等鉴权失败反复重连通常没有意义,应先修正令牌、Cookie 或请求头。
时间戳参数如何配合
-fflags +genpts 是输入选项,用于在缺少有效 PTS 时生成显示时间戳,因此必须写在 -i 之前。-avoid_negative_ts make_zero 是输出选项,只把开头的负时间戳整体平移到零附近,不会消除音视频之间原有的相对差值。
流复制不会重建帧节奏。若日志持续出现 Non-monotonous DTS,或重连后音画偏差不断扩大,可改用重新编码。片段示例:在主命令中用 -c:v libx264 -preset veryfast -c:a aac -af aresample=async=1000:first_pts=0 替换 -c copy,让编码器重新生成输出并对音频做渐进补偿。
HTTP 重连选项不等同于所有协议的通用自动恢复。RTSP、RTMP、SRT 和 UDP 各有自己的传输与超时参数;若协议层错误会直接结束进程,生产环境还应使用进程守护器重新启动录制,并为每次启动创建新文件,避免覆盖已保存内容。
验证录制文件
先检查容器、流类型和起始时间。持续直播的实际时长取决于停止时刻,因此示例使用占位值表示。
ffprobe -v error \
-show_entries format=format_name,duration \
-show_entries stream=index,codec_type,start_time \
-of default=noprint_wrappers=1 \
live-record.mkv预期输出
index=0
codec_type=video
start_time=<START_TIME>
index=1
codec_type=audio
start_time=<START_TIME>
format_name=matroska,webm
duration=<DURATION>随后从文件开头、一次断线恢复点和结尾各试听一段。重点检查画面是否跳回、声音是否突然积累延迟,以及文件结尾能否正常拖动;只确认文件存在,不能证明录制连续可用。
正常结束后封装为 MP4
当源视频和音频编码与 MP4 兼容时,可以直接复制数据,不重新编码。+faststart 会把索引移动到文件前部,便于网络点播更快开始。
ffmpeg -hide_banner -y \
-i live-record.mkv \
-c copy -movflags +faststart \
final.mp4预期输出
Input #0, matroska,webm, from 'live-record.mkv':
Output #0, mp4, to 'final.mp4':
frame=<N> time=<TIME> speed=<SPEED>
video:<SIZE> audio:<SIZE> muxing overhead:<PERCENT>若出现 codec not currently supported in container,说明至少一路编码不能直接写入 MP4,应选择兼容编码重新转码,而不是强行修改扩展名。