【共创稿事节】「不想上班」实战系列:压缩存、超分看——图像超分让随手记省空间又清晰
不想上班鸿蒙实战系列:压缩存、超分看——图像超分让随手记省空间又清晰
「不想上班」的随手记支持贴图:午饭的照片、停车小票、白板上的草图。图一多,一个老矛盾就浮出水面——原图存,空间扛不住;狠命压,回头看又糊。
HarmonyOS 7.0(API 26)CoreVisionKit 提供的图像超分能力,给了这个矛盾一个相当优雅的解法:存的时候放心压,看的时候 AI 补回来。本文基于「不想上班」的完整落地代码,把图像超分从"能调通"讲到"敢上线"。
一、为什么要超分:先想清楚再动手
1.1 官方定义与关键事实
官方文档对超分(超分辨率重建)的定义是:
在放大图片尺寸的同时,尽可能恢复和增强图片中的纹理、边缘等细节信息,减少普通插值缩放带来的模糊、锯齿或细节丢失问题。HarmonyOS 从 API 26.0.0 起支持对输入的低分辨率图像进行超分辨率重建。
有一个事实必须先记住,它会影响后面所有工程决策:超分返回的 PixelMap 像素尺寸同步放大为四倍。一张 1000×1000 的图进去,出来的是 4000×4000——这不是插值拉伸,是模型重建出来的细节,但内存占用也是实打实的 16 倍关系。
1.2 它适合解决什么
- 图片来源本身清晰度不足:聊天截图、历史存档、网络保存图;
- 需要放大查看:双指缩放、全屏浏览时,普通放大一片糊;
- 存储与显示诉求错位:存的是小图,看的时候想要大图。
「不想上班」的随手记图片三项全中。
二、「不想上班」的三段式图片链路
随手记的图片策略可以概括成九个字:压缩存、超分看、无损出。
- 压缩存:图片落盘前统一压缩——长边超过 1440px 等比缩到 1440,JPEG quality 80。一条日志几张图,空间占用直接砍到原来的零头;
- 超分看:大图预览页双击触发超分,模型把压缩图重建出细节,扫描揭示动画过渡;
- 无损出:保存/分享时给的是原图路径;只有在超分态下操作,才把超分结果落成临时文件导出。
矛盾就此化解:磁盘上的图是"经济适用房",用户眼睛看到的和导出去的可以是"精装版"。

三、API 速览:一个分析器,三个方法
超分能力挂在 @kit.CoreVisionKit 下,全部交互围绕 imageSuperResolution.ImageSRAnalyzer 一个类:
| 方法 | 签名 | 职责 |
|---|---|---|
| 创建 | ImageSRAnalyzer.create(): Promise<ImageSRAnalyzer> | 拿到分析器实例 |
| 处理 | process(request: visionBase.Request): Promise<ISPResponse> | 传入图片,返回超分结果 |
| 释放 | destroy(): Promise<void> | 用完释放服务 |
三条硬约束(官方文档原文口径,务必遵守):
- 输入尺寸:高、宽均需满足 16px < 边长 < 2048px,超界直接报错——大图必须先下采样再进门;
- 单次一张:
process只接受单张图片,不支持批量; - 建议规模:官方建议处理 1024×1024 以下的图片,高分辨率可能处理超时。
另外两条来自 Core Vision Kit 全局约束:不支持模拟器(只能真机验证);同一特性不支持同一进程并发调用(并发会返回系统繁忙错误)——后一条直接决定了我们后面的串行化设计。
调用的核心片段(官方示例的精简版):
import { imageSuperResolution, visionBase } from '@kit.CoreVisionKit';
const analyzer = await imageSuperResolution.ImageSRAnalyzer.create();
const imageData: visionBase.ImageData = { pixelMap: inputPixelMap };
const request: visionBase.Request = { inputData: imageData };
const response = await analyzer.process(request); // response.pixelMap 即 4 倍像素的结果
await analyzer.destroy();
create/process/destroy 都可能抛业务错误(如 1018700001 Service exception),全程 try/catch 是标配。
四、从能用到好用:五个工程化改造
官方 Demo 止步于"调通"。真进「不想上班」的预览页,还有五个坑位要填。
4.1 先问设备行不行:三级探测
我们的 compatibleSdkVersion 是 6.1.0(23),而超分是 API 26 的能力——必须做带版本判断的兼容探测,低版本直接隐藏入口。三层过滤,层层有分工:
/** 三级探测:API≥26 → canIUse VisionBase → 预创建 ImageSRAnalyzer(抛 801 视为不支持) */
private async probeSrSupport(): Promise<void> {
if (!isApiAtLeast(26) || !canIUse('SystemCapability.AI.Vision.VisionBase')) {
return;
}
let analyzer: imageSuperResolution.ImageSRAnalyzer | undefined = undefined;
try {
analyzer = await imageSuperResolution.ImageSRAnalyzer.create();
this.srSupported = true;
} catch (e) {
console.error('probeSrSupport unsupported:', JSON.stringify(e));
} finally {
if (!this.srSupported && analyzer) {
await analyzer.destroy();
}
}
}
API 版本挡掉老系统,canIUse 挡掉裁剪掉 VisionBase 能力的设备,最后真创建一次分析器做终审——探测成功就复用这个实例,失败则在 finally 里销毁,不留资源尾巴。srSupported 同时是入口显隐和交互开关,不支持就当这个功能不存在。
4.2 大图先瘦身再进门:2048 下采样
2048px 是接口硬约束,但用户拍的图动辄 4000px+。解码阶段用 desiredSize 等比下采样,一步到位,不做二次缩放:
/** 解码超分输入 PixelMap:沙箱路径直接创建,photoUri 按 fd 创建;
* 输入超 2048px(API 硬约束)时等比下采样解码 */
private async decodeInputPixelMap(uri: string): Promise<image.PixelMap | undefined> {
// ... 沙箱路径走 image.createImageSource(uri),媒体库 photoUri 开 fd 创建
const info = await imageSource.getImageInfo(0);
const options: image.DecodingOptions = {};
const maxSide = Math.max(info.size.width, info.size.height);
if (maxSide > 2048) {
const scale = 2048 / maxSide;
options.desiredSize = {
width: Math.floor(info.size.width * scale),
height: Math.floor(info.size.height * scale)
};
}
return await imageSource.createPixelMap(options);
}
等比缩到 2048 以内再喂给模型,输出仍可达 8192px 长边——对"查看"场景绰绰有余。注意 ImageSource 与 fd 在 finally 里成对释放。
4.3 结果状态机:整体替换 + 切图缓存
预览页支持左右滑切图,超分状态必须和"当前第几张"严格绑定。我们把结果建模成一个 @Observed 的聚合对象,在 PicturePreviewModel 里:
/** 超分结果:index 绑定图片下标,pixelMap 为超分图(undefined 表示非超分态),
* animate 控制扫描揭示动画(切图/退出重进需重播) */
@Observed
export class SrResult {
index: number = -1;
pixelMap?: image.PixelMap = undefined;
animate: boolean = false;
}
三个字段各管一件事:index 防"上一张的超分结果显示在这一张上"的错位;pixelMap 为空即普通态;animate 控制揭示动画是否重播。更新时整体 new 一个 SrResult 替换,触发 UI 刷新;同时用 srCache: Map<number, PixelMap> 缓存已超分结果,来回切图不重复跑模型;页面离页置 srDisposed 标志,异步回来的结果直接丢弃——Core Vision 不允许同特性并发,缓存 + 串行触发天然规避了"系统繁忙"。
4.4 离页不带走一片云彩:统一释放
超分结果的内存是普通图的 16 倍(4 倍宽 × 4 倍高),释放逻辑必须 centralized。预览页提供 releaseSrResources():遍历 srCache 逐个 release()、置空 srResult、销毁 analyzer。离页、退出超分态、页面销毁都走这一个口子,杜绝"某个分支忘了 release"的慢性泄漏。
4.5 超分图出门即焚:临时导出 + 幽灵清扫
保存/分享的设计前面说了:默认给原图路径。只有超分态下才把结果编码成临时文件:
/** 当前保存/分享的源路径:超分态时将超分结果编码为临时 jpg(跟随显示),否则返回原图路径 */
private async getCurrentImagePath(): Promise<string | undefined> {
const src = this.images[this.curIndex];
if (!(this.srResult.index === this.curIndex && this.srResult.pixelMap)) {
return src; // 非超分态:原图路径,零成本
}
// 超分态:createImagePacker 编码为 cacheDir 下固定文件名的临时 jpg
}
固定文件名(sr_export.jpg)是刻意的:分享面板打开期间进程被杀,离页清理不会执行,临时文件会变幽灵。配套的 cleanSrExportCache 在 EntryAbility 启动时按名单清除:
// EntryAbility.onCreate 中:
// 超分导出临时文件:分享面板打开期间进程被杀会残留,启动时按固定文件名清扫
cleanSrExportCache(this.context);
保存到相册则走 SaveButton 安全组件 + photoAccessHelper 的 createAsset 按 fd 拷贝,不申请相册写权限——超分图"用完即焚",只有用户显式保存的那张才配进相册。
示例:
图片超分前:

图片超分后:
也许这样看效果并不明显,但是如果两张图片放到统一同一尺寸下对比还是挺明显的:

(示例图片来源于互联网,如有侵权请联系删除)
五、上线前的自查清单
- 版本与能力探测缺一不可:API 26 + canIUse + 真实 create,三步都过才亮入口;低版本系统上功能静默消失是特性,不是 bug。
- 输入先过 2048 这关:高宽 16px~2048px 是硬约束;官方建议 1024×1024 以下,更大可能超时——下采样是必选项不是可选项。
- 一次只喂一张图:process 不支持批量;同特性并发会吃系统繁忙错误,串行队列或触发去重二选一。
- 结果绑定下标:可滑动预览场景,结果必须和 index 锁死,异步回调回来先对 index。
- 内存按 16 倍算账:4 倍边长 = 16 倍像素,缓存条数要有上限意识,离页统一释放。
- 真机验证:Core Vision Kit 不支持模拟器,别在模拟器上等一个永远不会来的结果。
六、总结
图存下了,也看得清了。下一个问题来了:上周那张停车小票,到底记在哪条日志里?靠手翻几百条随手记显然不现实。
系列的下一篇,我们给同一批图片接上 CoreVisionKit 的文本搜图能力——不标注、不打 tag,输入"停车"两个字直接把图捞出来。超分管"看得清",搜图管"找得到",随手记的图片链路才算闭环。
参考文档
- 图像超分(开发指南):https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/core-vision-image-super-resolution
- imageSuperResolution(图像超分)API 参考:https://developer.huawei.com/consumer/cn/doc/harmonyos-references/core-vision-image-super-resolution-api
- Image 组件(autoResize / interpolation 最佳清晰度配置):https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-image
- 图片细节增强(image-processing-arkts):https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/image-processing-arkts
- 不想上班下载链接
更多推荐


所有评论(0)