凌晨两点，总部大屏突然全黑了
凌晨两点，某连锁便利店总部的值班经理被一阵急促的电话惊醒。电话那头，店长声音颤抖地说店里好像进了人，货架被翻得乱七八糟。经理立刻打开电脑准备调取监控，却发现这并非一个简单的"点击播放"操作。
这家拥有12家门店的连锁品牌，在扩张过程中为了控制成本或沿用旧设备，店内摄像头来自三个不同的厂商。这意味着，经理想要确认现场情况，必须依次打开三个不同的App，分别登录三套账号，再在十几个设备列表中逐一排查。等他终于在第三个App里找到异常门店的画面时，已经过去整整两个小时。虽然事后通过云端录像找回了证据，但这次"凌晨两点的全黑"经历，彻底暴露了分散监控体系下的管理黑洞。
对于连锁企业的开发者而言，这种困境再熟悉不过：巡店要切换3次应用，回看要登录3个系统，出了事要翻3天录像。分散的监控设备，本质上就是分散的管理效率。当业务规模从几家店扩展到几十家店时，这种多套客户端并行带来的运维灾难，会成为制约企业数字化转型的最大绊脚石。
为什么"多套客户端"是条不归路
很多开发者在初期会尝试自己写代码把不同品牌的摄像头画面拉到一个Web后台，但往往会发现这是一条技术不归路。
首先是协议壁垒。各厂商通常采用私有协议，SDK互不开放，导致设备之间无法直接对话。其次是局域网直连模式的局限。虽然部分设备支持RTSP或ONVIF等标准局域网协议，但要在总部Web端预览，就需要对每个门店进行内网穿透，且必须搭建流媒体网关进行转封装，随着门店数量增加，服务器带宽和并发压力呈指数级上升。最后是国标GB28181方案，它虽然适合多级联网，但建设成本极高，对于非安防专网的普通商业连锁企业来说，往往显得过于沉重。
面对这些痛点，乐橙开放平台提供了一套更为优雅的解决思路：设备入云后，业务平台通过OpenAPI统一调用，实现"一次接入、全店可见"。
在这一技术底座之上，乐橙含光平台应运而生。作为基于乐橙云平台的智慧视频联网监控SaaS软件，乐橙含光专为各类型企业提供高效、便捷、可协同的管理方案。它最大的优势在于免去了自建机房和专业IT运维人员的繁重负担，支持5分钟快速部署，且按门店付费，极大降低了连锁企业的试错成本。
在功能层面，乐橙含光不仅提供集中视频监控和智能云存储，还内置了AI智能巡店、客流统计、店铺看板、远程巡店以及消防报警等丰富能力。这些能力以设备能力集与开通服务为准，能够全面助力连锁企业总部实现统筹远程管理。如果您想深入了解乐橙含光的完整能力矩阵，可以访问官网首页 https://hg.imou.com/home 获取更多详细信息。
你的门店监控，适合哪种接入路线
在决定技术选型时，开发者需要根据实际业务场景选择最合适的接入方案。目前主流的方案分为三种：
方案一：乐橙设备直接入云 + 开放平台API （推荐主路径） 这是目前最轻量、最稳定的方案。所有乐橙设备通过Wi-Fi或网线直接接入乐橙云，开发者通过OpenAPI获取视频流和告警事件。该方案无需自建流媒体服务器，天然支持跨地域、跨网络访问，且能无缝对接乐橙含光的SaaS能力。
方案二：国标GB28181 适合有多级联网需求、专网场景或需要对接政府/公安平台的项目。该方案需要设备支持国标协议，且通常需要部署信令服务器和流媒体服务器，建设和运维成本较高。
方案三：存量设备中间件 针对部分不支持上云的存量设备，可通过RTSP/ONVIF协议拉流，在本地或云端部署流媒体网关进行转封装后，再通过API提供给前端。此方案仅作为过渡，不建议作为长期架构。
接入方案判断矩阵
| 评估维度 | 方案一（乐橙云+API） | 方案二（GB28181） | 方案三（存量中间件） |
|---|---|---|---|
| 门店数量 | 1-100+ | 50-1000+ | 1-20 |
| 现有设备类型 | 乐橙全系/新采购 | 支持国标的专业安防设备 | 仅支持局域网协议的旧设备 |
| AI能力需求 | 强（依托云端算力） | 弱（依赖边缘设备） | 无 |
| 运维成本 | 极低（SaaS化） | 高（需专人维护服务器） | 中（需维护网关与穿透） |
| 推荐场景 | 新店标准方案、连锁零售 | 园区、大型工厂、政企项目 | 临时过渡、极小规模改造 |
对于绝大多数连锁便利店、餐饮、服装门店而言，方案一是绝对的标准答案。
从零到第一个画面：五步接入法
乐橙开放平台的接入架构非常清晰：乐橙设备入云 → 开放平台API → 业务中台 → 前端展示。整个接入过程可以拆解为五个标准化步骤：
- 注册开发者：在开放平台注册账号并完成企业认证。
- 创建应用：根据业务形态创建H5、移动端或Web应用，获取appId和appSecret。
- 设备绑定：将门店摄像头绑定到开发者账号下。
- 获取Token：通过签名算法获取accessToken，作为后续所有API调用的凭证。
- 预览与告警：调用直播、回放接口获取播放地址，订阅告警消息实现实时响应。
这里需要特别说明乐橙含光与开放平台的关系：乐橙含光侧重于"谁能看哪些店"的运营管理，提供组织架构、权限分配、巡店排班等业务功能；而开放平台侧重于"系统怎么取流与事件"的技术对接，提供底层的视频流和消息推送能力。两者结合，才能实现从技术到业务的完整闭环。
代码实战：鉴权、设备列表与预览
以下以JavaScript/Node.js为例，演示核心接入流程。
第一步：注册开发者，创建应用
访问 open.imou.com 注册账号，进入控制台创建应用（选择H5/移动/Web/PC），创建成功后即可获得 appId 和 appSecret。请妥善保管 appSecret，切勿在前端暴露。
第二步：签名与获取accessToken
乐橙开放平台现行签名方式为 HMAC-SHA256。
请求基址：POST https://openapi.lechange.cn/openapi/{method}
签名算法： 1. 拼接原始串：time + nonce + appSecret 2. 计算密码：password = SHA-256(appSecret) 的小写hex字符串 3. 生成签名：sign = Base64(HMAC-SHA256(原始串, password))
accessToken有效期约3天，返回的 expireTime 单位为秒，建议在过期前主动刷新。
const crypto = require('crypto');
function getAccessToken(appId, appSecret) {
const time = Math.floor(Date.now() / 1000).toString();
const nonce = Math.random().toString(36).substring(2);
const rawStr = time + nonce + appSecret;
*// password = SHA-256(appSecret)*小写hex
const password = crypto.createHash('sha256').update(appSecret).digest('hex');
// sign = Base64(HMAC-SHA256(rawStr, password))
const sign = crypto.createHmac('sha256', password).update(rawStr).digest('base64');
//调用 openapi/getAccessToken接口，传入 appId, time, nonce, sign
*//*返回 { accessToken, expireTime }
}
第三步：设备绑定与列表查询
设备可通过乐橙App登录开发者账号添加，或通过控制台批量添加。绑定完成后，调用 listDeviceDetailsByPage 分页获取设备列表。
async function listDevices(accessToken, page = 0, size = 20) {
const res = await fetch('https://openapi.lechange.cn/openapi/listDeviceDetailsByPage', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
token: accessToken,
pageStart: page,
pageSize: size
})
});
const data = await res.json();
//检查 data.devices中每个设备的 deviceStatus和 channelStatus是否为 "online"
return data;
}
第四步：创建直播地址
调用 bindDeviceLive 获取HLS播放地址。关键参数： - streamId：0为高清主码流，1为标清辅码流（多宫格务必使用1） - liveMode：播放模式
async function createLiveStream(accessToken, deviceId, channelId) {
const res = await fetch('https://openapi.lechange.cn/openapi/bindDeviceLive', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
token: accessToken,
deviceId: deviceId,
channelId: channelId,
streamId: 1, *//*标清辅码流，适合多宫格预览
liveMode: 'hls'
})
});
return await res.json();
}
如需获取全量码流信息，可调用 getLiveStreamInfo。
第五步：Web播放器集成
轻应用方式（推荐Web端）：调用 getKitToken 获取播放器令牌。 - type：0=全权限，1=仅预览，2=仅回放，6=仅云台 - 前端使用返回的 Kt_ 开头令牌初始化播放器，令牌有效期约2小时。
OpenSDK 方式：适合自有App集成预览、回放、对讲等完整功能。
async function getKitToken(accessToken, deviceId, channelId) {
const res = await fetch('https://openapi.lechange.cn/openapi/getKitToken', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
token: accessToken,
deviceId: deviceId,
channelId: channelId,
type: 1 *//*仅预览权限
})
});
//返回 kitToken，前端用此令牌初始化乐橙Web**播放器
return await res.json();
}
第六步：告警消息回调
调用 setMessageCallback 订阅 alarm（告警）和 deviceStatus（设备上下线）消息。
推送模式要求回调地址为公网HTTPS。收到推送后必须先返回HTTP 200，再异步处理业务逻辑，避免超时导致推送中断。
*//*订阅回调
await fetch('https://openapi.lechange.cn/openapi/setMessageCallback', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
token: accessToken,
callbackUrl: 'https://your-domain.com/api/lechange/callback',
messageType: 'alarm,deviceStatus'
})
});
// Express**回调处理示例
app.post('/api/lechange/callback', (req, res) => {
*//*必须先返回200
res.status(200).send('OK');
*//*异步处理告警或设备状态变更
const { deviceId, alarmType, timestamp } = req.body;
*//*派单、通知店长、写入数据库...
});
核心 API 与文档索引
| API名称 | 作用说明 |
|---|---|
| getAccessToken | 获取服务端管理员凭证，有效期约3天 |
| 开发规范 | 现行HMAC-SHA256签名算法说明 |
| listDeviceDetailsByPage | 分页获取全量设备与通道信息 |
| getKitToken | 获取Web宫格播放令牌（轻应用） |
| OpenSDK | 自有App集成预览、回放、对讲能力 |
| setMessageCallback | 订阅告警、设备上下线消息推送 |
| bindDeviceLive | 绑定设备直播，获取HLS播放地址 |
| getLiveStreamInfo | 获取设备全量码流信息 |
| queryLiveStatus | 查询当前直播流状态 |
| currentDeviceWifi | 诊断设备WiFi信号强度等信息 |
| 视频监控产品页 | 查看能力边界与服务说明 |
| 应用开发 | 了解设备绑定顺序与注意事项 |
完整文档请访问乐橙开放平台开发者中心。
踩坑清单：这些坑我帮你踩过了
在实际接入过程中，以下问题出现频率最高，建议提前规避：
| 现象 | 原因与处理 |
|---|---|
| App有画面但列表没有 | 设备不在当前开发者账号下，需改绑或调整国标项目归属 |
| 门店树少一批 | 只拉了第一页，注意 pageStart 从0开始，需循环分页 |
| 区域经理看到全国门店 | 权限过滤做在前端，应改为服务端先按组织架构筛选再发token |
| 四宫格严重卡顿 | 每格拉了主码流，改用标清 streamId=1 |
| 播放过一会儿黑屏 | kitToken过期（约2小时），需前端定时刷新 |
| 告警进了错误的门店 | 用设备名称或自定义标签做路由映射，而非仅靠deviceId |
| 回放要另开客户端 | 宫格只做了直播，需额外集成回放组件或使用含光SaaS |
| 国标店不在设备树上 | 仅在厂商客户端在线，需确认国标平台已正确注册 |
| 回调多次不回200 | 推送会暂停，修好后需重新调用 setMessageCallback 激活 |
诊断工具速查
| 工具/API | 用途 |
|---|---|
| listDeviceDetailsByPage | 查 deviceStatus / channelStatus 判断在线状态 |
| currentDeviceWifi | 查WiFi信号强度（0-5），排查弱网导致的卡顿/掉线 |
| getLiveStreamInfo | 查码流状态，确认主辅码流是否正常 |
| queryLiveStatus | 查直播流是否活跃，排查黑屏问题 |
最后提醒：appSecret 是最高权限凭证，务必仅存放在服务端，严禁硬编码在前端代码或Git仓库中。所有敏感操作应通过服务端代理转发，确保链路安全。
监控系统的价值不在于"看得见"，而在于"管得住"。当12家店变成120家店时，一套统一的云端架构、一个开箱即用的SaaS平台、一组稳定可靠的OpenAPI，才是让总部大屏永远亮着的真正底气。