更新记录

1.0.0(2026-08-04)

  • 首版:Android 图片压缩
  • 支持按最大宽高缩放、质量与输出格式
  • 自动纠正 EXIF 方向,避免压缩后旋转
  • 定价:普通授权 ¥9.90 / 源码授权 ¥49.00

平台兼容性

uni-app

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
- - - - - 5.0 × ×
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 小红书小程序 快应用-华为 快应用-联盟
- - - - - - - - - - - -

uni-app x

Chrome Safari Android iOS 鸿蒙 微信小程序
- - 5.0 × × -

Thor-image-compress

Thor 安卓图片压缩 UTS 插件(第一版仅 Android)。

按最大宽高压缩,并自动纠正 EXIF 方向,避免 uni.compressImage 常见「压缩后旋转」问题。

功能

  • maxWidth / maxHeight 等比缩放
  • EXIF 方向纠正(90 / 180 / 270 / 镜像等)
  • 输出 jpg / png / webp
  • 可调 JPEG/WEBP 质量

用法

import { compressImage } from '@/uni_modules/Thor-image-compress'

compressImage({
  src: '/storage/emulated/0/.../a.jpg', // 或 uni.chooseImage 返回的路径
  maxWidth: 1280,
  maxHeight: 1280,
  quality: 80,
  format: 'jpg',
  success(res) {
    console.log(res.tempFilePath, res.width, res.height, res.size)
  },
  fail(err) {
    console.log(err.errCode, err.errMsg)
  }
})

参数

字段 类型 默认 说明
src string - 本地图片路径(支持 file://
maxWidth number 1280 最大宽;<=0 表示该方向不限制
maxHeight number 1280 最大高;<=0 表示该方向不限制
quality number 80 1-100,PNG 忽略质量
format string jpg jpg / png / webp

成功返回

字段 说明
tempFilePath 压缩后本地路径(带 file:// 前缀,可直接用于 <image> / 上传)
width / height 输出尺寸
size 文件字节数

错误码

errCode 含义
1001 参数无效
1002 源文件不存在
1003 解码失败
1004 写出失败
1099 其它异常
9001 平台不支持(预留)

平台

  • Android:已实现(minSdk 21)
  • iOS / 鸿蒙:未实现

注意

  1. 调用方需保证 src 可读(可先用 uni.chooseImage / 文件选择插件拿到本地路径)。
  2. 修改 UTS 后需重新制作自定义调试基座。
  3. 超大图会先 inSampleSize 降采样,再精确缩放到目标边长。

售价

  • 普通授权版:¥9.90
  • 源码授权版:¥49.00

隐私、权限声明

1. 本插件需要申请的系统权限列表:

仅读取用户传入的本地图片路径进行压缩,不额外申请相册/存储权限(调用方需自行保证路径可读)。

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集、不上传任何用户数据;图片仅在本机压缩处理。

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

暂无用户评论。