图片解密组件
图片解密组件
开放平台 ImageDecrpt 资源包提供 Java 平台端 解密能力：根据设备加密告警图在 OSS 上的 URL，下载并解密，供服务端落库、推送富媒体、AI 分析等场景使用。包内 Open-PicDecode 为 Spring Boot 参考实现，对外暴露 HTTP 接口 POST /decodePic。
与客户端 OpenSDK、轻应用 ImouPlayer 的分工不同：本组件面向 你的后台服务，不替代 App 内 decryptPic 或 Web 播放器的 code 参数。
适用场景与分工
| 场景 | 推荐方式 | 说明 |
|---|---|---|
| App 内告警缩略图、录像封面 | Android / iOS OpenSDK decryptPic | Android 日志与解密 · iOS 工具与解密 |
| 轻应用 / H5 实时预览码流 | ImouPlayer 参数 code | 见 码流与告警图片解密 — 轻应用 |
| 服务端处理 OSS 告警图 URL | 本组件 POST /decodePic | 需 accessToken、设备 deviceId、密钥 secretKey |
| PC 客户端本地解密 | PC OpenSDK / Demo | 见 PC 功能集成 |
端到端背景（加密策略、密钥含义）见 开发指南 — 码流与告警图片解密 与 媒体安全：码流与图片加密。
能力概要
- 按 URL 解密：传入 OSS 图片地址，内部下载密文并调用乐橙原生解密库（JNA）。
- TCM 分支：通过 OpenAPI
listDeviceDetailsByIds读取deviceAbility，若包含TCM则走 TCM 解密路径；否则走常规定制密钥 / 设备密码逻辑（与 Demo 注释及 API 参考 — secretKey 一致）。 - 统一响应：
ApiResult包装，code=200成功时data.decodePic为 Base64 编码的明文 JPEG/PNG 字节。
本套件
| 页 | 内容 |
|---|---|
| 安装与部署 | JDK、Maven 打包、application.properties、Linux 启动 |
| API 参考 | /decodePic 请求体、响应体、HTTP 状态与业务码 |
| Demo 工程 | 目录结构、依赖、与业务系统集成方式 |
| 错误码与排障 | 平台码、OpenAPI 码、原生 SDK 解密码 |
资源包下载见 SDK 资源下载 — ImageDecrpt（resourceType=ImageDecrpt）。