从旧接口迁移到设备能力
从旧接口迁移到设备能力
新接入推荐流程:
- 调用 device.capability.list 查询设备支持的能力 ID。
- 按 设备能力与事件 目录找到对应 property / service 页,使用
device.property.get/device.property.set/device.service.invoke(见 能力使用)。 - 尚未提供能力封装的场景,可继续使用 设备配置与操作(重启、校时、WiFi 等维护类 HTTP)及 设备管理 下的查询/绑定类接口。
常见对照(节选)
| 场景 | 设备能力(推荐) | 遗留 HTTP(兼容) |
|---|---|---|
| 宽动态 | image.wdr.mode · 宽动态 | — |
| 恢复出厂 | device.restore.execute · 恢复出厂 | — |
| 重启 | device.reboot.execute · 重启设备 | restartDevice |
| 动检开关 | detection.motion.enabled · 获取 / 设置 | 设备动检配置 各接口 |
| 动检区域 | 能力目录 动检 下区域相关 property | 同上 |
| 夜视 | 夜视(如 image.night.*) | — |
| WiFi 维护 | WiFi 与 网络 域 | 设备配置与操作 WiFi 类接口 |
上表为非穷举对照;完整能力清单以 device.capability.list 返回为准,勿仅凭上表推断。
各端实现
服务端 HTTP
迁移在服务端完成:先 device.capability.list,再按能力页调用 property/set/invoke;遗留 HTTP 仍由后台请求 OpenAPI。客户端 OpenSDK 不替代能力路径鉴权。