通道国标 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