区域经理要三家店截图,同事在海康客户端、乐橙App、Excel之间切了五次。海康、大华、宇视要统一看,不是再下一套厂商客户端,而是设备按GB/T 28181向平台SIP注册,再用accessToken走同一套设备管理、预览、回放、对讲、告警。
切五次 App,根因往往是协议层还没汇聚
A 店挂在海康客户端,B 店是后来装的乐橙机,C 店在 Excel 里只有简称。经理再问昨晚后仓,同事又切回其中一个 App。五次切换,不是运维手生,是三家厂商三套私有客户端,资产没进同一池。
拆机重买不现实。现行解法写在国标产品介绍:大华、海康、宇视的 IPC / NVR 可按 GB/T 28181-2011/2016 接入乐橙开放平台,通信优先 TCP。利旧、统一管理,上线后不必为国标再写一套业务 API。
上线之后,巡店要的仍是六件事——和视频监控能力同一张能力表。
国标负责「怎么进来」,OpenAPI / 组件负责「进来之后怎么看」
| 设备管理 | 控制台「国标 GB28181 接入」看注册;业务侧仍用 listDeviceDetailsByPage | 和乐橙协议设备同一套管理口径 |
| 预览 | 控制台先验 HLS;应用走轻应用或 OpenSDK | 产品范围含实时视频 |
| 回放 | 本地录像 / 云录像走组件或云直播 | 国标云存文档写明采用行业通用明文传输方案 |
| 对讲 | 预览建立后再开对讲 | 文档列出海康、大华国标设备语音对讲;宇视以设备能力与现行页为准 |
| 告警 | 云端事件推送 | setMessageCallback |
| 开放接入 | accessToken + 轻应用 / OpenSDK | 国标设备接入说明:已有协议无需二次开发 |
总体步骤见总体流程与详细流程。接入数、带宽与普通通道统一计费,每台国标通道算 1 路。
接入五步:从企业认证到第一路国标出画
第一步:企业认证,创建国标项目
首次建国标项目要先完善企业信息并认证通过,再填项目信息。个人随便玩两台机、不走企业认证的,走不通这条轨。成功:控制台能建国标项目,能看到 SIP 服务 ID。失败:卡在认证,先联系平台客服,不要先改设备 Web。
第二步:绑定国标 IPC / NVR
平台可自动生成设备国标 ID,也可自定义——原项目已有国标 ID 时建议复用,少改设备侧。支持批量。多目国标摄像机按 NVR 方式接入。成功:设备列表里出现待注册记录,能导出给现场。
第三步:设备 Web 填 SIP,优先 TCP
名词对齐详细流程:
| SIP 服务 ID | 国标项目唯一 ID |
| SIP 服务域 | SIP 服务 ID 的前十位 |
| SIP 服务器域名 | gbaccess-online-hz.imou.com;不支持域名时可用 8.154.21.254(建议在安装地 ping 域名确认) |
| SIP 服务器端口 | 控制台给出的注册端口 |
| 设备国标 ID / 密码 | 与控制台该设备一致 |
海康 NVR 要点见海康 NVR 本地配置:平台接入选 28181;通道号与通道国标 ID 顺序必须和控制台一致,乱序会导致「能看但看串店」。大华 / 宇视按文档各自的本地配置页填,不在这里编会改版的菜单路径。
三家现场差异通常出在 Web 菜单名字,不在平台 SIP 字段:平台要的还是服务 ID、域、域名或 IP、端口、设备国标 ID、密码。实施清单按控制台导出,不要让师傅在设备上「凭经验填一串 20 位」。有的老设备只认 IP、不认域名,文档已给 8.154.21.254,并建议在安装城市 ping gbaccess-online-hz.imou.com 再写。
第四步:约 60 秒看在线,再验 HLS
配置完成后约 60 秒内注册。控制台「国标 GB28181 接入 – 设备管理」看状态;在线后再到直播服务验 HLS。应用对接前先确认平台侧能播,避免把 SIP 失败误判成播放器 bug。
第五步:应用对接——轻应用或 OpenSDK,仍是六件事
设备在线且播放正常后,详细流程指向云直播或轻应用。现行签名换 accessToken,列表、getKitToken、对讲、setMessageCallback 与乐橙机同一套路。OpenSDK 近期 Demo 已写明支持国标预览、对讲、回放,类名与初始化以OpenSDK 组件和官方 Demo 为准。
新装乐橙机仍走 App / SDK 绑定,和国标机进同一开发者账号,巡店页不必知道哪路是 SIP。
代码与流程:SIP 留在现场,业务只认 deviceId
海康 / 大华 / 宇视 IPC、NVR
│ 设备 Web:28181 + TCP + SIP
▼
gbaccess-online-hz.imou.com 注册(约 60s)
│
▼
控制台:国标在线 + HLS 试播
│
▼
accessToken → listDeviceDetailsByPage
├─ 轻应用 imouPlayer / OpenSDK 预览·回放·对讲
└─ setMessageCallback 告警进你的 HTTPS
// 国标上线后的业务侧,与乐橙机同一壳;密钥不出网
const { accessToken } = await callOpenApi('accessToken', process.env.IMOU_APP_ID, process.env.IMOU_APP_SECRET, {});
const page = await callOpenApi('listDeviceDetailsByPage', process.env.IMOU_APP_ID, process.env.IMOU_APP_SECRET, {
token: accessToken, page: 1, pageSize: 20, source: 'bindAndShare',
});
// 把 deviceId/channelId 写进门店表,protocolTag 仅给运维看,前端不展示「海康/乐橙」
签名、callOpenApi 实现与现行开发规范相同:HMAC-SHA256,标准案例 sign 为 xjhCQBoJ9hRDsCjyDcHjtDNzRZ3ZJezcawsfWeiaoxU=。不要为国标再抄一套旧栏目接口。
现场给实施的是 SIP 参数表,不是 appSecret。
联调会踩的坑
| 一直离线 | UDP 不稳定、SIP 填错、企业项目未建好 | 改 TCP;对控制台逐项核对;确认认证通过 |
| 能注册但画面串店 | NVR 通道国标 ID 与控制台顺序不一致 | 按通道号重排,不要只改设备名称 |
| 域名填不进去 | 部分老设备只认 IP | 用文档 IP,并在安装地 ping 域名 |
| 多目只有一路 | 按 IPC 而不是 NVR 方式绑 | 改按 NVR / 多通道绑定 |
| 对讲无声 | 该路厂商/能力不在对讲范围内,或未先预览 | 先查产品范围;先出画再对讲 |
| 业务列表没有国标机 | 只盯厂商客户端,没拉开放平台列表 | listDeviceDetailsByPage;确认在开发者账号下 |
国标通道计入接入数和带宽,可配日流量 / 推流路数预警,避免利旧之后把配额打满。
协议进池子,巡店才离开厂商客户端
那次「切五次 App」里,海康客户端不是同事的习惯问题,是存量机还没按国标进开放平台。SIP 注册完成,设备管理、预览、回放、对讲、告警才能和乐橙机坐同一张墙。
只换新机、不留老 NVR 的项目,不必上国标轨。能力与国标范围以产品页和国标介绍为准:视频监控开放能力。
乐橙开放平台支持国标设备与乐橙设备统一管理,并用同一套开放接口做预览和事件。注册:https://open.imou.com

