使用分享给我的设备
使用分享给我的设备
乐橙 App 用户可以把设备分享给开发者账号(与 托管授权 不同:分享是 App 侧分享关系,托管是用户把权限交给开发者)。当前文档中,查询这类设备的主接口是 shareDeviceList(遗留接口分组,仍可调用)。本接口列表不含 托管授权 设备;托管设备见该指南中的接口与流程。
能力边界
- 接口说明:分页获取乐橙 app 分享给开发者设备列表。
- 需使用 管理员 accessToken(
params.token)。 - 返回设备列表含在线状态、型号、能力项等字段;具体字段见接口页。
- 分享后的具体操作权限以乐橙 App 分享设置为准;开放平台侧按接口最小权限与 授权模型 调用。
建议步骤
取得管理员 token
按 获取 token 调用 accessToken。不要在客户端保存管理员 accessToken。分页拉取分享设备列表
调用 shareDeviceList,queryRange为区间字符串(如1-10),见接口页合法值说明。后续操作
预览、回放、配置等需使用列表返回的deviceId、通道信息,并选用与场景匹配的 token(管理员或子账号)及接口。绑定在自己账号下的设备见 设备管理。与托管区分
用户通过托管链接授权的设备不走 shareDeviceList,见 接收终端用户托管的设备。