4. RTSP接入实战
在旭日视频流部署链路中，RTSP接入是整条流水线的第一环。它决定了后续解码、抽帧与BPU推理能否获得稳定、连续、可追溯的视频帧。很多部署失败并非模型问题，而是RTSP客户端连接不稳定、会话未正确维护或异常未及时恢复。本节从连接建立、会话管理、异常处理三个层面展开实战方法。
一、核心原理：RTSP不是“拉流”这么简单
RTSP是控制协议，真正的媒体数据由RTP承载。一次完整的接入通常包含：OPTIONS探测能力、DESCRIBE获取SDP、SETUP建立传输通道、PLAY启动播放，以及后续的TEARDOWN释放。若使用TCP传输，RTP会通过RTSP连接进行交织传输；若使用UDP，则需额外处理丢包与端口协商。理解这一点，才能解释为什么“能连上但没画面”往往出在SETUP或PLAY阶段。
在旭日平台上，推荐优先使用TCP传输，因为它在弱网和NAT环境下更稳定，且便于与解码器对接。典型连接参数包括：超时时间、传输模式、缓冲区大小、重连间隔。这些参数直接决定接入的鲁棒性。
二、方法流程：从连接到稳定拉流
实战中建议按以下步骤实现RTSP客户端：
- 探测与描述：先发OPTIONS确认服务端支持的方法，再发DESCRIBE获取SDP，解析出视频编码、分辨率、帧率与SPS/PPS。
- 建立传输：根据网络环境选择TCP或UDP。TCP模式设置
rtsp_transport=tcp，并适当增大buffer_size。 - 启动播放：发送PLAY后进入读帧循环，按时间戳或帧序号驱动后续解码与抽帧。
- 会话保活：按SDP中的
timeout或服务端要求，周期性发送OPTIONS或GET_PARAMETER，防止Session过期。 - 异常恢复：捕获超时、EOF、RTP丢包、解码错误等信号，执行TEARDOWN并重建会话。
以FFmpeg/OpenCV为例，关键配置如下：
# 使用TCP传输并设置超时
ffmpeg -rtsp_transport tcp \
-stimeout 5000000 \
-i "rtsp://admin:pass@192.168.1.64:554/Streaming/Channels/101" \
-f rawvideo -pix_fmt bgr24 -
# OpenCV 设置
cap = cv2.VideoCapture(rtsp_url, cv2.CAP_FFMPEG)
cap.set(cv2.CAP_PROP_BUFFERSIZE, 3)
cap.set(cv2.CAP_PROP_OPEN_TIMEOUT_MSEC, 5000)
cap.set(cv2.CAP_PROP_READ_TIMEOUT_MSEC, 5000)
三、会话管理：Session ID与保活策略
RTSP是有状态协议，服务端通过Session头标识会话。若客户端长时间不发送请求，服务端会回收Session，导致后续读帧失败。常见保活方式有两种：一是周期性发送OPTIONS，二是发送GET_PARAMETER。前者兼容性更好，后者更轻量。保活间隔建议为服务端超时时间的1/2到2/3。
在旭日部署中，建议将会话管理封装为独立模块，维护状态机：IDLE → CONNECTING → PLAYING → RECONNECTING → CLOSED。每次状态迁移都记录日志与时间戳，便于排障。对于多路视频，应为每路维护独立会话，避免相互阻塞。
四、异常处理：典型故障与恢复策略
RTSP接入的异常大致分为网络层、协议层、媒体层三类。网络层包括连接超时、断网、NAT端口失效；协议层包括401鉴权失败、404路径错误、Session过期；媒体层包括SPS/PPS缺失、编码不支持、时间戳跳变。不同异常应有不同的恢复动作，而不是一律重连。
| 异常类型 | 典型现象 | 判断依据 | 恢复策略 |
|---|---|---|---|
| 连接超时 | 无法建立TCP连接 | connect timeout | 指数退避重连，检查网络与端口 |
| 鉴权失败 | 401 Unauthorized | DESCRIBE返回401 | 校验用户名密码与URL编码 |
| Session过期 | PLAY后无数据 | 454 Session Not Found | 重建会话并恢复保活 |
| RTP丢包 | 画面花屏、卡顿 | 丢包率统计升高 | 切换TCP或增大缓冲 |
| 编码不支持 | 解码器初始化失败 | SDP中codec异常 | 切换子码流或转码 |
五、案例与复盘：一次“能连上但无画面”的排障
某现场使用旭日X3派接入海康IPC，日志显示DESCRIBE成功、SETUP成功，但PLAY后始终读不到帧。排查发现：客户端使用UDP传输，而设备所在交换机禁用了UDP端口范围，导致RTP无法到达。改为TCP interleaved后立即恢复。复盘结论：连接成功不等于媒体可达，必须验证RTP是否真正到达，并在SETUP阶段就确认传输模式与网络策略匹配。
综上，RTSP接入实战的关键在于：用状态机管理会话，用保活维持连接，用分类异常处理替代盲目重连。只有把连接、会话与异常三件事做扎实，后续解码、抽帧和BPU推理才能获得稳定输入。