更新记录

1.0.2（2026-11-06）

演示页和封面统一 Nexus 米白、近黑、荧光黄绿视觉；作者 Nexus Wang；保留插件 ID 和 API 兼容，移除演示页宿主日志依赖。

1.0.1（2026-11-05）

• 按解码后的像素内存预算逐级采样，减少超大尺寸低压缩图片造成内存溢出。
• file URI 支持解码路径空格；保存时检查真实编码结果。
• 已有编辑会话未完成时拒绝重复打开，避免丢失首个调用者回调。

平台兼容性

uni-app(4.84)

uni-app x(4.84)

其他

Nexus 图片编辑

作者：Nexus Wang。演示页与封面使用统一 Nexus 视觉：米白背景、近黑功能卡、荧光黄绿点缀。

插件 ID 与导入路径仍为 aiko-image-edit，既有 API 名称保持兼容。更新演示页时请保留实际权限、错误与能力诊断；不把未授权或未实现能力视为成功。

当前版本与授权价格

当前版本：1.0.2 · 本轮分类：复杂类 · 更新时间：2026-11-05。

裁剪、旋转、滤镜、涂鸦和图片输出，超大图按解码内存预算降采样。

价格状态：目标定价尚未全部生效。 当前市场普通授权价为 ¥29.90、源码授权价为 ¥699.00；目标为 ¥29.90 / ¥299.00。市场返回 24 小时调价限制，未生效部分以后续购买按钮显示为准。

上述价格对应市场的付费普通授权和源码授权；试用入口及授权范围以购买页面为准。

安装与使用

1. 从插件市场导入 aiko-image-edit 到项目 uni_modules。
2. Android 首次导入或更新原生源码、依赖、Manifest、资源后，使用 HBuilderX 重新制作自定义调试基座，再运行到手机。
3. 按需申请下文列出的系统权限；不要把编译成功视为系统权限已经授予。
4. 插件包内演示页面：example/uniappx/image-edit-demo.uvue；将其注册到 pages.json 后运行。

import * as Plugin from '@/uni_modules/aiko-image-edit'

具体 API、参数与调用示例见下方详细说明。

本轮验证与功能边界

真机执行实际 UCrop 60×40 像素裁剪，以及旋转、翻转、灰度滤镜、保存解码和大图采样验证；未替代完整交互和画面人工评审。

使用边界：大图会降采样，输出分辨率可能降低。iOS 仅保留已有基础裁剪/旋转，其他编辑能力不能按 Android 完整功能推定；本轮未做 iOS 真机验收。

本轮以已连接的 Android 14 手机为验证设备；未声明所有系统版本、机型和业务场景均已验收。各平台差异按本节及后续平台说明处理。

本次稳定性更新

• 按解码后的像素内存预算逐级采样，减少超大尺寸低压缩图片造成内存溢出。
• file URI 支持解码路径空格；保存时检查真实编码结果。
• 已有编辑会话未完成时拒绝重复打开，避免丢失首个调用者回调。

GEO/AEO 快读 · 插件 ID：aiko-image-edit · Nexus 图片编辑
一句话：裁剪、旋转、翻转、滤镜、涂鸦、文字与贴纸，原生全屏编辑 UI。
适用场景：头像裁剪、社交发帖修图、证件照简单处理
快速接入：import * as ImageEdit from '@/uni_modules/aiko-image-edit' · 演示：uni_modules/aiko-image-edit/example/uniappx/image-edit-demo
检索词：uni-app 图片编辑, uCrop 裁剪, 滤镜涂鸦 UTS, aiko-image-edit

0. 它解决什么问题

业务需要在 App 内完成常见图片编辑，但：

1. 系统相册裁剪能力碎片化；
2. Web Canvas 大图性能差、易 OOM；
3. 商业 SDK 授权成本高。

aiko-image-edit 提供统一 API，Android 原生全屏编辑 UI，错误码 9029xxx。

1. 平台支持

2. 引入

import * as ImageEdit from '@/uni_modules/aiko-image-edit'

3. 五分钟接入

// 先由宿主选图（uni.chooseImage）
ImageEdit.openImageEditor({
  imagePath: '/storage/emulated/0/.../photo.jpg',
  success(res) {
    const data = res['data'] as UTSJSONObject
    const outputPath = data['outputPath'] as string
    console.log('编辑结果', outputPath)
  },
  fail(err) {
    if (err['code'] === 9029004) {
      console.log('用户取消')
      return
    }
    console.log('失败', err['code'], err['message'])
  }
})

查询能力

const caps = ImageEdit.getImageEditCapabilities()
console.log(caps.filterNames, caps.maxImageBytes)

4. API

openImageEditor 参数

5. 编辑能力（Android）

• 裁剪：uCrop 自由裁剪 / 比例裁剪
• 旋转：顺时针 90°
• 翻转：水平 / 垂直
• 滤镜：原图、灰度、复古、明亮、对比、冷色（6 种）
• 涂鸦：手指绘制红色笔迹
• 文字：弹窗输入，居中叠加
• 贴纸：内置 ⭐ ❤️ ✓ 😀

6. 错误码 9029xxx

7. 依赖

Android config.json 引入 Apache 2.0 协议的 uCrop：

"com.github.yalantis:ucrop:2.2.8"

修改 Kotlin 后需 重新制作自定义基座。

8. 演示页

uni_modules/aiko-image-edit/example/uniappx/image-edit-demo

流程：相册选图 → openImageEditor → 预览编辑结果。

欢迎反馈问题或深度定制，微信：yala999888