通道国标 ID 贴反会串店:海康大华宇视摄像头怎么用 GB28181 统一接入?

海康、大华、宇视的 IPC 或 NVR,按 GB/T 28181 向乐橙开放平台做 SIP 注册,传输优先 TCP。在线后用 accessToken 调 listDeviceDetailsByPage,预览、回放、对讲走轻应用或 OpenSDK。


在线了,收银画面却是后仓

连锁项目联调时遇到过这种情况:控制台显示国标设备在线,HLS 也能播,业务页里 A 店收银却是后仓。原因不在播放器,而在海康 NVR 的通道国标 ID 顺序和控制台不一致。现场按通道名称对过,没有按通道号对。

大华、宇视也会出现同类问题。三家 Web 菜单名称不同,20 位国标 ID 又长得接近,抄错一位就是离线,顺序贴反就是串店。存量店通常不会为了统一观看把 NVR 拆掉。设备侧只做 GB/T 28181 注册,注册完成之后,预览、回放、对讲、告警与乐橙绑定设备走同一套开放接口。范围见视频监控开放能力和国标产品介绍。

实施单建议固定六列:门店、通道名、SIP 服务 ID、服务域、设备国标 ID、密码。域名和端口全项目相同,写在表头。贴完后由另一人核对两处:服务域是否为服务 ID 的前十位,通道 1 的国标 ID 是否等于控制台通道 1。菜单路径会改版,核对项保持这六项,传输选择 TCP。

注册成功后做一次串店核对:店员在收银镜头前挥手,业务页应出现该店收银。对不上时先查通道顺序。乐橙新机与这台 NVR 若在同一个开发者账号下,门店表用同一个门店编码挂多路,页面展示门店名和点位名。


国标负责进来,OpenAPI 负责进来之后

要的结果 上线后怎么做 验收
出现在同一张设备表 控制台看注册;业务侧调 listDeviceDetailsByPage 能按门店编码找到该 NVR
实时预览 控制台先验 HLS,应用再用轻应用或 OpenSDK 标清出画
录像回放 回放窗,或轻应用录播 type=2 能拖到指定时间
语音对讲 预览建立后再开 以该设备现行能力说明为准
告警 setMessageCallback 推到业务 HTTPS 遮挡或上下线能到达业务系统
鉴权 accessToken;播放用短时 kitToken appSecret 不出服务端

每台国标通道按 1 路计入接入数和带宽。多目摄像机按 NVR 方式接入。只更换乐橙新机、不保留老 NVR 的项目,走普通绑定即可,不必建国标项目。总体步骤见总体流程与详细流程。


接入步骤

第一步:企业认证,创建国标项目

首次创建国标项目需先完成企业认证。认证通过后,控制台能看到 SIP 服务 ID。认证未完成时,先不要改设备 Web。

第二步:生成或复用设备国标 ID

平台可自动生成,也可沿用原项目已有 ID,以减少改设备。支持批量导出。把导出表交给现场,避免口头传递 20 位数字。

第三步:设备 Web 填写 SIP,传输选 TCP

名词 填法
SIP 服务 ID 国标项目唯一 ID
SIP 服务域 服务 ID 的前十位
SIP 服务器域名 gbaccess-online-hz.imou.com;设备不支持域名时用文档 IP 8.154.21.254,安装地先 ping 域名
端口、设备国标 ID、密码 与控制台该行一致

海康 NVR 的平台接入选择 28181,通道号与通道国标 ID 的顺序和控制台一致,见海康 NVR 本地配置。大华、宇视按各自文档的本地配置页填写。

安装地先 ping gbaccess-online-hz.imou.com。只放行固定地址的网络,改用文档 IP,并放行控制台给出的注册端口。传输方式固定为 TCP。企业认证材料和 SIP 密码分开发放,实施单写「见控制台对应行」。

第四步:约 60 秒看在线,再验 HLS

到「国标 GB28181 接入 - 设备管理」查看状态。平台侧能播之后,再交给应用。超过约两分钟仍离线,逐项核对导出表。

第五步:应用侧接同一套接口

签名按开发规范使用 HMAC-SHA256。accessToken 放服务端缓存,按 expireTime 提前刷新。listDeviceDetailsByPage 的 page 从 1 起,pageSize 为 1~50,只拉第一页会漏掉后注册的设备。

Web 用轻应用,自有 App 用OpenSDK。getKitToken 的 type 与播放器直播/录播 type 不是同一套枚举。对讲在预览成功后再打开。setMessageCallback 的接收端先回 HTTP 200,再异步入库。

第六步:按能力验收

列表中有该设备,标清预览出画,回放能到指定时间,需要时对讲有声,遮挡或上下线能进回调。对讲若现行说明只覆盖部分品牌,验收单单独注明「本路无对讲」。离场条件是挥手能对上正确通道,而不只是状态为在线。

国标通道计入接入额度和带宽。上线前在控制台核对剩余通道和流量。督导墙用标清,单路点播再提高清晰度。额度以控制台显示为准。


流程示意

text 复制代码
海康 / 大华 / 宇视 IPC、NVR
        │ 28181 + TCP + 与控制台一致的 SIP
        ▼
  gbaccess-online-hz.imou.com   注册(约 60 秒)
        │
        ▼
  控制台在线 + HLS 试播 + 挥手核对通道
        │
        ▼
  accessToken → listDeviceDetailsByPage
        ├─ 轻应用 / OpenSDK     预览 · 回放 · 对讲
        └─ setMessageCallback   告警进入业务 HTTPS

请求地址为 POST https://openapi.lechange.cn/openapi/{method}。国标设备与乐橙绑定设备共用这一调用壳。查阅文档时使用现行栏目。


边界与踩坑

国标接入得到的是视频和平台侧事件,不自动包含客流、离岗、着装。对讲和云存储以设备能力集及已开通服务为准。

现象 先查什么
一直离线 是否仍为 UDP;SIP 六项是否与导出表一致;企业项目是否已建成
在线但画面串店 通道国标 ID 顺序。只改通道名称无效
域名无法填写 使用文档 IP,安装地先 ping
多目只有一路 改为按 NVR / 多通道绑定
对讲无声 先出画,再核对现行能力说明
业务列表没有这台 调用 listDeviceDetailsByPage,不要只看厂商客户端
另写了一套国标接口 注册与业务调用分开,预览和事件仍走上述 API

多目设备只出一路时,回到绑定方式,按 NVR 通道重做。注册端口、域名和 IP 以控制台及详细流程为准。

相关推荐
wuyk55533 分钟前
Python办公自动化-第01讲-环境搭建与自动化认知
python·自动化·pyqt
光电笑映2 小时前
TCP 为什么可靠?从三次握手、滑动窗口到拥塞控制全面拆解(下)
linux·网络·网络协议·tcp
琳少_4 小时前
java程序开发笔记
java·开发语言·数据库·笔记
Pocker_Spades_A7 小时前
工业物联网时序数据库选型:一份能直接抄走的技术规格书
数据库·物联网·时序数据库
如夏倾城7 小时前
入侵检测系统(IDS)原理、部署模式与 IPS/防火墙对比
大数据·网络·人工智能·网络安全·云原生·架构·kubernetes
Z21-X7 小时前
云原生运维学习笔记:Kubernetes Volume 与 Secret 实验
运维·笔记·学习·云原生·kubernetes
一只大鸽子8 小时前
游戏开发笔记7-Godot RPG游戏基础-场景切换、全局脚本
笔记·游戏·godot
LabVIEW开发8 小时前
LabVIEW 用 25 ns 精度捕捉赛车发动机共振
网络·labview·labview知识·labview功能·labview程序
赤生云电竞10 小时前
云游戏边缘节点部署实践:机房选址与网络拓扑选型
网络·游戏·php