乐橙云开发文档
控制台
更新日志
控制台
更新日志
快速入门
  • 开始使用
  • 核心概念
  • 开发指南
    • 账号与授权
    • 设备接入
      • 在控制台或乐橙 App 添加设备
      • 通过接口绑定设备
      • 在 App 内配网并绑定
      • 接入国标 GB28181 设备
      • 国标设备厂商配置
      • 查询、改名与解绑设备
      • 升级设备固件
      • 排障:绑定失败、设备离线
    • 音视频
    • 控制与配置设备
    • 接收设备事件
    • 云存储
    • AI分析
    • 门锁与门铃
    • 上线与排障
  • 设备能力与事件参考
  • API 参考
  • SDK 与工具
  • 行业方案
  • 平台与支持
本页目录
本页目标
步骤
各端实现
相关参考

升级设备固件

升级设备固件

本页目标

在服务端发起设备固件升级,并轮询升级状态与进度(HTTP 调用,建议放在后台)。

升级接口为 upgradeDevice:设备升级;进度为 upgradeProcessDevice:获取设备升级状态和进度。字段以两页 OpenAPI 说明为准。设备维护类接口索引见 设备管理 API。

进度查询见 upgradeProcessDevice API 页。

服务端用 HTTP 流程见下表;移动端可走 Android 示例工程 中的 OpenSDK 升级封装(本页 platforms: [H] 仅展开 HTTP 步骤)。

步骤

  1. 调用 upgradeDevice 发起升级(子账号需 Upgrade / dev:序列号)。
  2. 轮询 upgradeProcessDevice,建议间隔 3–5 秒,直到 status 回到 idle 或 percent 达 100;若超过约 30 分钟仍停在 downloading/upgrading,查在线状态后按下方失败处理重试。
  3. 关注返回中的 version、status(idle / downloading / upgrading)、percent;列表结构见接口页 deviceVersionList 样例。

升级失败或卡在 downloading/upgrading 时,查设备在线状态与 排障,必要时重试 upgradeDevice(以接口页约束为准)。

各端实现

服务端 HTTP

发起升级和查询进度都由服务端调用上述两个接口。参数以原接口页为准。

相关参考

  • 设备维护说明
  • 设备查询说明
  • upgradeDevice:设备升级
  • upgradeProcessDevice:获取设备升级状态和进度
  • 查询、改名与解绑设备

商务合作:cloud_openteam@imou.com · 工单 · 获取帮助(公众号、小程序试用中心)

Copyright © 2015-2026 IMOU. All Rights Reserved. 浙ICP备16023676号

查询、改名与解绑设备
排障:绑定失败、设备离线