更新记录

1.1.2（2026-08-13）

-修复ios最新环境内联问题

1.1.1（2026-07-26）

-Android 鸿蒙 IOS 添加仿微信策略视频压缩功能 -Android 鸿蒙 IOS优化图片压缩功能参数

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)

uni-app x(4.18)

其他

ly028-Compress

📱 下载体验 APK

三端（Android / iOS / HarmonyOS）UTS 图片 + 视频 压缩插件。图片接近微信朋友圈策略；视频统一码率/分辨率算法，异步压缩、进度回调、可取消。

安装

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

import {
  compressImagesAsync,
  compressVideoAsync,
  getVideoInfoAsync,
  getVideoThumbnailAsync,
  clearVideoCacheAsync,
  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 仍可能回调一次（失败信封，提示已取消）。

compressVideoAsync

compressVideoAsync(
  options: CompressVideoOptions,
  : ((json: string) => void) | null,
  onComplete: ((result: string) => void) | null
): number

options

快捷预设 preset

一行配置即可，对应参考库的 CompressionConfig.***() 等：

// 微信朋友圈
compressVideoAsync({ path, preset: 'wechat' }, , onComplete)

// ***-like: 720p, quality 65, 30fps
compressVideoAsync({ path, preset: '***' }, , onComplete)

// Social media: 1080p, quality 70, 30fps
compressVideoAsync({ path, preset: 'social' }, , onComplete)

// Light: keep resolution, quality 90
compressVideoAsync({ path, preset: 'light' }, , onComplete)

// Maximum: 480p, quality 30, 24fps
compressVideoAsync({ path, preset: 'maximum' }, , onComplete)

// 预设 + 覆盖个别字段
compressVideoAsync({ path, preset: 'wechat', quality: 70 }, , onComplete)

说明：frameRate 在 iOS 会写入合成帧时长；Android / Harmony 以分辨率与码率为主（系统转码 API 对帧率控制能力不一）。quality / maxHeight / audioBitrate 三端均生效。

onProgress.phase

metadata / transcode / stripAudio / complete

onComplete data（解析后）

getVideoInfoAsync / getVideoThumbnailAsync / clearVideoCacheAsync

getVideoInfoAsync(path, onComplete)
getVideoThumbnailAsync({ path, positionMs?, quality?, maxHeight?, targetDir? }, onComplete)
clearVideoCacheAsync(onComplete)

缩略图成功时 data 含 path（JPEG）、width、height、fileSize。

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