GB28181

GB28181 网关接入指南:注册、保活、目录、调看和录像回放

面向国标视频联网项目,说明 GB28181 上联、下级平台接入、目录、INVITE 调看、PS/RTP 媒体、录像检索和现场验证要点。

GB28181 不是一个播放地址

GB28181 是完整的视频联网协议体系,不只是“给一个地址播放”。它包含 SIP 注册、保活、目录、设备状态、控制、INVITE 调看、PS/RTP 媒体发送、录像检索和回放等流程。项目里只验证一条视频能出来,远远不够。

选型和联调前,先明确 StreamGate 在项目中的角色:作为下级平台注册到上级平台,还是作为接入网关管理下级设备。两种角色的配置、媒体方向和验收项不同。

上联平台需要确认什么

项目说明
SIP 服务地址和端口上级平台给下级注册的地址
域和设备 ID影响注册、目录和通道编码
认证方式用户名、密码、有效期和鉴权失败日志
媒体端口PS/RTP 发送端口和防火墙策略
目录规模设备、通道、分组和名称规范
调看方式实时预览、录像回放、云台(PTZ)和告警是否验收

常见联调问题

注册失败通常与 SIP 地址、域、ID、密码、端口、防火墙或时间同步有关。目录不显示通常与编码规则、目录推送、通道状态或上级平台缓存有关。INVITE 有信令但没有画面,通常要检查媒体 IP、RTP 端口、NAT、码流编码和上级平台收流日志。

GB28181 的难点往往不在单个接口,而在真实平台的兼容性。不同上级平台对目录、心跳、录像检索、云台(PTZ)、告警和媒体参数的要求可能不同,正式部署前需要用目标平台验证。

StreamGate 的适用场景

StreamGate 可用于摄像头、NVR 和现有视频流的统一接入,再按项目需要与上级 GB28181 平台对接。它适合需要本地 Web Console、浏览器预览、录像回放、开放接口和国标联网同时存在的项目。

如果只是单一路国标测试,配置看起来不复杂;但如果涉及几十路、上百路、多个 NVR、录像回放和业务系统接口,就需要把通道命名、目录结构、服务器容量和授权通道数一起规划。

验收建议

  1. 验证注册、保活和注销。
  2. 验证目录推送、通道在线离线和名称显示。
  3. 验证实时 INVITE 调看和 PS/RTP 媒体。
  4. 验证云台(PTZ)、录像检索和录像回放是否属于项目范围。
  5. 验证断网恢复、平台重启、网关重启和长时间运行日志。
  6. 记录上级平台版本、配置截图、端口、码流和异常日志,作为交付依据。

先确认系统角色

GB28181 项目必须先确认当前系统是向上级平台注册的下级设备/平台,还是作为上级平台接入下级设备。两个方向涉及的注册、目录、INVITE、媒体端口和联调方式不同。角色不清,会直接影响报价、开发量和验收计划。

联调资料清单

建议提前准备 SIP ID、域、服务器地址、端口、认证方式、媒体端口范围、设备编码、目录规模、是否需要录像回放、是否需要级联以及目标平台厂商信息。GB28181 不能只靠本地模拟器判断,最终要和真实平台互通。

录像和实时调看的区别

实时调看关注 INVITE、PS/RTP 媒体发送和断线恢复;录像回放还需要目录、时间范围、检索和回放控制。选型时要明确只是上联实时流,还是要覆盖完整录像检索回放。

GB28181 接入与上联要分清方向

GB28181 场景里要区分下级设备接入、本机网关服务和向上级平台注册。StreamGate 作为网关时,可以接入下级设备或平台,并向上级平台提供通道和媒体;StreamCore SDK 的 GB28181 能力则更偏向客户端或应用侧向上级平台注册并响应 INVITE、发送 PS/RTP 媒体。

项目评估时应先确认平台编码、SIP 域、设备 ID、端口、传输方式、目录规模、保活周期、录像检索需求和网络边界。国标链路一旦涉及多级平台或跨网段,日志、事件、在线状态和会话诊断比单纯“支持 GB28181”更重要。