更新记录

1.0.0（2026-07-25）

• 首发：Android / iOS / HarmonyOS 三端统一 API
• 接近微信朋友圈的自适应图片压缩
• 批量压缩、进度回调、任务取消
• 可选参数：ignoreBy / quality / focusAlpha / excludeGif / maxConcurrency / targetDir / renamePrefix
• 多语言：zh-Hans / en
• Demo：压缩前后分辨率、体积、压缩率比对

平台兼容性

uni-app(4.18)

其他

ly028-Compress

📱 下载体验 APK

三端（Android / iOS / HarmonyOS）UTS 图片压缩插件。接近微信朋友圈的画质与体积策略，异步压缩、进度回调、可取消。

安装

将本插件放入项目的 uni_modules/ly028-Compress 目录（插件市场导入或手动拷贝均可）。

import {
  compressImagesAsync,
  cancelCompress,
  setLocale,
  getLocale
} from '@/uni_modules/ly028-Compress'

快速开始

uni.chooseImage({
  count: 9,
  sizeType: ['original'],
  success: (res) => {
    const jobId = compressImagesAsync(
      { paths: res.tempFilePaths },
      (progressJson) => {
        const p = JSON.parse(progressJson)
        // p.percent / p.current / p.total / p.phase / p.path
        console.log(p.percent)
      },
      (resultJson) => {
        const res = JSON.parse(resultJson)
        if (res.code !== 0) {
          uni.showToast({ title: res.msg || 'compress failed', icon: 'none' })
          return
        }
        const data = typeof res.data === 'string' ? JSON.parse(res.data) : res.data
        // data.files: 每张图的压缩结果
        console.log(data.files)
      }
    )
    // 需要中途停止时：
    // cancelCompress(jobId)
  }
})

API

压缩在后台线程执行，不会阻塞 UI。onProgress / onComplete 回到主线程，可直接更新界面。

compressImagesAsync

compressImagesAsync(
  options: CompressImagesOptions,
  : ((json: string) => void) | null,
  onComplete: ((result: string) => void) | null
): number

options

需要特殊文件名时：压缩完成后读取结果里的 outputPath，再自行拷贝/重命名即可。

onProgress（JSON 字符串）

onComplete（JSON 字符串信封）

{
  "code": 0,
  "subCode": 0,
  "msg": "ok",
  "data": "{ ... }"
}

data 解析后：

files[] 单项

cancelCompress

cancelCompress(jobId: number): boolean

取消后，该任务的 onComplete 仍可能回调一次（失败信封，提示已取消）。

setLocale / getLocale

setLocale('zh-Hans') // 或 'en'
getLocale()          // 当前语言

影响插件返回的 msg 等内置文案；不影响你业务 UI 自己的多语言。

使用注意

1. 路径：相册与拍照返回的临时路径均可传入 paths。请使用 uni.chooseImage / 本地文件路径；插件会做常见路径归一化。
2. 展示图片：App 端 <image> 对绝对路径有时需加 file:// 前缀，例如 file:///data/.../xxx.jpg。uni.previewImage 一般可直接使用返回路径。
3. 输出目录：未指定 targetDir 时写入 _doc/ly028-compress/（应用文档目录），返回路径为 _doc/... 形式，可直接给 <image> / uni.previewImage 使用。正式业务仍可再拷贝到其它持久位置或上传后自行管理。
4. 体积策略：小于 ignoreBy（默认 100KB）通常不压；压缩后若比原图更大，会回退保留原图数据（keptOriginal: true）。

平台

需在 App 真机或自定义基座中验证原生能力（HBuilderX 标准运行可能无法完整测试 UTS 原生插件）。

体验

📱 下载体验 APK