视频能力进阶
一、功能范围
视频能力进阶用于说明 GB28181 接入后的直播、回放、PTZ、语音对讲、URL 拉流、代理流、录像服务和移动端播放等能力。
二、视频链路
三、URL拉流绑定设备
适用于已有 RTSP、RTMP、HTTP-FLV、HLS、fMP4 等流地址的场景。
操作路径：
text
视频中心 > 通道管理 > 新增通道 > 设备绑定URL 拉流通道示例：
配置重点：
| 字段 | 说明 |
|---|---|
| 通道名称 | 便于在设备详情中识别 |
| 流地址 | RTSP、RTMP、HTTP-FLV、HLS 等地址 |
| 播放协议 | 根据浏览器和播放器能力选择 |
| 关联设备 | 绑定后可在设备详情中查看 |
| 关联场景 | 可用于组态或场景页面 |
四、代理拉流
代理拉流适合摄像头无法直接被浏览器访问，或需要平台统一输出播放地址的场景。
常见问题：
| 问题 | 处理方式 |
|---|---|
| RTSP 无法播放 | 检查摄像头账号密码、网络、ZLM 是否可访问摄像头 |
| 播放黑屏 | 检查编码格式、浏览器支持、是否需要转码 |
| 播放几秒后断开 | 检查保活、超时、NAT、防火墙 |
| 多人播放卡顿 | 检查服务器带宽、ZLM 配置、播放协议 |
五、录像与回放
录像能力分为设备本地录像和云端录像。
云端录像示例：
| 类型 | 说明 | 前置条件 |
|---|---|---|
| 设备本地录像 | IPC/NVR/DVR 自带存储 | 设备支持查询和点播 |
| 云端录像 | 平台侧录制并存储 | ZLM、录像服务、存储配置可用 |
回放排查：
- 通道是否在线。
- 时间范围是否有录像。
- 播放协议是否被浏览器支持。
- ZLM Hook 是否正常。
- OSS 或本地存储是否可读。
六、PTZ与语音对讲
PTZ 控制依赖设备能力和协议支持。语音对讲还需要设备、浏览器、媒体服务共同支持。
排查重点：
- 设备是否声明支持 PTZ。
- 通道 ID 是否正确。
- SIP 信令是否成功。
- 浏览器麦克风权限是否允许。
- TCP 主动对讲或国标对讲方式是否与设备一致。
- 服务端音频编码是否匹配设备。
七、移动端播放
移动端播放建议优先选择兼容性更好的协议，并控制同时播放路数。
| 场景 | 建议 |
|---|---|
| 小程序或移动浏览器 | 优先 HLS 或兼容播放器支持的协议 |
| 实时性要求高 | 评估 WebRTC 或低延迟 FLV |
| 多分屏 | 控制清晰度和同时播放数量 |
| 弱网 | 降低码率，增加重连提示 |
八、二次开发入口
| 类型 | 路径或接口 | 说明 |
|---|---|---|
| 视频接口 | /common/player | 播放、停止、回放、代理拉流 |
| PTZ 接口 | /common/ptz | 云台控制 |
| 通道接口 | /iot/channel | 通道管理和设备绑定 |
| SIP 服务 | springboot/fastbee-server/sip-server | GB28181 信令 |
| ISUP 服务 | springboot/fastbee-server/isup-server | ISUP 设备能力 |
| 录像服务 | springboot/fastbee-record | 录像和 ZLM Hook |
| 前端页面 | vue3/src/views/iot/sip、vue3/src/views/iot/device | 视频页面入口 |