设备接入
设备接入
本主题说明如何把设备绑定到开发者账号，并完成查询、国标接入与固件升级。按下方任务表进入分步指南；HTTP 请求与返回字段以各页链到的 OpenAPI 方法页为准。
本主题任务
| 任务 | 说明与入口 |
|---|---|
| 在控制台或乐橙 App 添加设备 | 添加设备 方式一、方式二 |
| 通过接口绑定设备 | bindDevice：绑定设备；新出厂设备可能要结合客户端 SDK，见 应用开发 |
| 在 App 内配网并绑定 | 仅移动应用支持设备配网，见本页「各端支持」；客户端步骤见 应用开发 |
| 接入国标 GB28181 设备 | 产品介绍 的产品范围；接入指南内 总体流程、详细流程 |
| 国标设备厂商配置 | 只链到已有厂商配置页 |
| 查询、改名与解绑设备 | 设备查询、modifyDeviceName、unBindDevice |
| 升级设备固件 | upgradeDevice、upgradeProcessDevice |
| 排障：绑定失败、设备离线 | 常见绑定与在离线排查 |
| 终端用户设备托管 | 终端用户将乐橙 App 下设备权限托管给开发者；流程、权限码、setDeviceAuthStatus 与托管事件报文见 接收终端用户托管的设备；店铺类场景见 SaaS 平台接入终端用户设备 |
管理他人设备时，除绑定自有设备外，可使用设备托管：终端用户在托管页授权，开发者通过控制台或 批量设置设备的托管状态 接收托管。推送 warrantInit 等见 接收终端用户托管的设备 · 托管事件 与 配置平台消息推送。
接入方式
| 方式 | 说明 |
|---|---|
| 控制台添加 | 添加设备 方式二，入口为 设备接入服务 |
| 乐橙 App 添加 | 添加设备 方式一。使用开发者账号登录乐橙 App 后添加 |
| 接口绑定 | bindDevice：绑定设备，步骤见 通过接口绑定设备 |
| App 内配网 | 移动应用支持设备配网。云直播、轻应用、桌面应用不支持。步骤见 在 App 内配网并绑定 |
| 托管 | 终端用户把已有设备授权给开发者，见 接收终端用户托管的设备 |
| 国标 GB28181 | 大华、海康、宇视主流厂商 IPC/NVR 可以通过 GB/T28181 2011/2016 版本接入，见 产品介绍 |
各端支持
| 移动应用对接 | 云直播对接 | 轻应用对接 | 桌面应用对接 | |
|---|---|---|---|---|
| 设备配网 | 支持 | 不支持 | 不支持 | 不支持 |
Android、iOS、鸿蒙、小程序的配网步骤见 在 App 内配网并绑定。
服务端做什么 / 客户端做什么
应用开发 的分工是：
- 设备配网、设备初始化、音视频播放：参考 Demo，使用客户端 SDK。
- 账户绑定、设备绑定与解绑、设备管理、设备操作、云存储和报警消息：由后台服务调用 HTTP 接口。图片解密除外。
控制台和乐橙 App 的操作步骤见 添加设备。
前提
先注册并认证，创建应用后在应用信息中取得 AppId 与 AppSecret。顺序见 控制台完成首次实时预览。
请妥善保存账户信息。后续设备绑定、开发和增值服务购买都基于这个开发者账号。
账号下还没有设备时，可在乐橙官方商城 mall.imou.com 购买，并用乐橙 App 添加。