编码与格式 / 系统课时
读取常见网络媒体流
读取常见网络媒体流
本课解决“网络流能打开但不稳定、延迟高或长时间无响应”的问题。你将用 FFmpeg 读取 HTTP、HLS、RTSP 与 RTMP 等常见输入,并通过超时、传输协议和缓冲参数获得可验证的本地媒体文件。
学习目标
- 识别常见网络媒体地址及其读取方式
- 正确设置输入超时、RTSP 传输方式和低延迟参数
- 根据日志区分协议不可用、连接失败与媒体流异常
协议与关键选项
FFmpeg 把网络地址放在 -i 后作为输入。HTTP/HTTPS 文件、HLS 播放列表和 RTMP 地址通常可直接读取;RTSP 还需要根据网络环境选择 TCP 或 UDP。输入相关选项必须写在对应的 -i 之前,否则可能被当成输出选项。
| 输入类型 | 地址示例 | 常用设置 |
|---|---|---|
| HTTP/HTTPS | https://media.example/video.mp4 |
-rw_timeout 限制网络读写等待时间 |
| HLS | https://media.example/live/index.m3u8 |
直接读取播放列表,必要时设置超时 |
| RTSP | rtsp://camera.example/live |
-rtsp_transport tcp 或 udp |
| RTMP | rtmp://live.example/app/stream |
直接读取,关注服务端鉴权和连接状态 |
-rw_timeout 的单位是微秒,例如 5000000 表示 5 秒。TCP 更适合存在丢包、防火墙或跨公网的 RTSP 链路;UDP 通常延迟更低,但丢包时更容易出现花屏或断续。
主示例:读取 RTSP 流
下面的 Bash 命令通过 TCP 拉取 RTSP 流,最多等待 5 秒完成一次网络读写,并录制 20 秒到 Matroska 文件。-map 0:a? 中的问号表示音频轨道不存在时不报错。
ffmpeg -hide_banner -loglevel info \
-rtsp_transport tcp \
-rw_timeout 5000000 \
-i "rtsp://user:password@camera.example/live" \
-t 20 \
-map 0:v:0 \
-map 0:a? \
-c copy \
-y capture.mkv预期结果
Input #0, rtsp, from 'rtsp://user:password@camera.example/live':
Stream #0:0: Video: h264, <PIXEL_FORMAT>, <WIDTH>x<HEIGHT>, <FPS> fps
Output #0, matroska, to 'capture.mkv':
frame=<FRAME_COUNT> ... time=00:00:20.00 ...实际分辨率、帧率和帧数会随输入流变化。-c copy 不重新编码,因此 CPU 占用低,也不会改变原始画质;但输出容器必须支持输入中的编码格式。若需要边拉流边转码,应把 -c copy 替换为明确的视频和音频编码器。
低延迟场景可在 -i 前尝试加入 -fflags nobuffer -probesize 32k -analyzeduration 0。这些设置会缩短探测与缓冲时间,但网络抖动或流信息出现较晚时,可能导致轨道识别失败,因此不应作为所有场景的默认配置。
验证与常见失败
录制结束后,用 ffprobe 检查文件是否包含可读取的视频流。该命令只输出关键字段,便于脚本判断结果。
ffprobe -v error \
-select_streams v:0 \
-show_entries stream=codec_name,width,height \
-of default=noprint_wrappers=1 \
capture.mkv预期输出
codec_name=h264
width=<WIDTH>
height=<HEIGHT>若日志出现 Protocol not found,先执行 ffmpeg -protocols 检查当前构建是否包含对应协议。Connection timed out 通常指向地址、端口、防火墙或服务端不可达;401 Unauthorized 表示鉴权失败;持续出现解码错误则应检查丢包、传输方式和源流本身。更换 RTSP 的 TCP、UDP 传输方式时,应保持其他参数不变再比较结果。