SaaS平台接入终端用户设备

场景与目标

B 端开发者建设「店铺管理系统」：各门店设备挂在门店乐橙 App 账号下，通过托管授权给开发者账号后，再在自有系统中做预览、对讲、回放与管理。授权模型见 自有设备与用户设备。

架构

设备经乐橙 App 绑定；门店通过 App 向开放平台发起托管；开发者账号在托管通过后调用 OpenAPI / SDK 访问设备（预览、对讲、回放、管理等）。

用到的文档链接

• 托管开通、链接、setDeviceAuthStatus：接收终端用户托管的设备
• 托管完成推送 "msgType": "warrantInit"，state 原样回传：托管事件
• 管理者观看：按场景选 选择集成方式（移动 OpenSDK、轻应用、云直播、桌面等），入门见 应用开发
• 计费：计费

分阶段实现

开通托管服务

官网控制台开通托管服务并取得托管链接（示例 https://open.imou.com/h5/company/abcde12345678910）。控制台逐步操作以当前控制台界面为准。

配置托管页面

在控制台配置托管页展示项并取得访问地址；可配置项以控制台为准。

托管链接带回业务参数

需在托管完成时带回业务参数：在链接上拼接 state（建议加密），例如 https://open.imou.com/h5/company/abcde12345678910?state=...。不拼接时直接将托管链接分发给终端用户（短信、二维码、门店系统等）。

终端用户发起设备托管

终端用户用乐橙 App 账号打开托管页并选择要托管的设备；带 state 的链接同上。

开发者接收设备托管

控制台或 setDeviceAuthStatus 确认接收托管。

托管完成回调

平台推送 warrantInit；state 原样返回。字段见 托管事件。

托管设备操作

在托管授权范围内调用 OpenAPI；权限矩阵见 托管权限。上线后按业务做巡检、告警与续费（计费与配额见 计费）。

上线清单

• 已开通托管并取得托管链接与托管页地址。
• 需要业务回传时已配置 state（建议加密）。
• 终端用户已完成托管；开发者已接收托管（控制台或 setDeviceAuthStatus）。
• 已选定集成方式并完成预览/回放等核心链路联调。
• 已阅读计费与隐私合规要求（SDK 见各端 隐私与合规 等）。