更新记录

1.1.0(2026-11-19)

首次发布:完成 Android / HarmonyOS 双端实现与真机验证。


平台兼容性

uni-app x(4.25)

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

其他

多语言 暗黑模式 宽屏模式 蒸汽模式
× × × √

uni-camera-pro 相机图片增强插件

开箱即用的图片后处理插件,纯系统 API 实现,无三方 SDK 依赖。补齐 uni-app x 内置拍照(takePhoto/compressImage)缺少的图片增强能力。

平台支持

平台 支持 最低版本 说明
Android ✅ 5.0 (API 21) 基于 Bitmap/Canvas,文字/图片水印、裁剪、旋转、信息
HarmonyOS ⚠️ 部分 API 9+ 图片信息、裁剪、旋转可用;水印需 Drawing Canvas,当前降级
iOS ⏸ — 后期规划

快速开始

import { addTextWatermark, crop, rotate } from '@/uni_modules/uni-camera-pro'

// 加文字水印(时间戳,右下角)
addTextWatermark({
  src: photoPath,
  text: '2026-11-19 18:30',
  position: 'bottomRight',
  success: (res) => console.log(res.path)
})

// 全屏平铺水印(证件/样张防外传)
addTextWatermark({
  src: photoPath,
  text: '仅供办理 XX 业务使用',
  position: 'fullscreen',  // 整图斜向平铺
  alpha: 0.18,             // 透明度,浅 0.1 / 中 0.18 / 深 0.32
  rotate: -30,             // 倾斜角度,负值向左上倾斜
  gapX: 0,                 // 水平间距,0 = 按文字宽度自动
  gapY: 0,                 // 垂直间距,0 = 按文字高度自动
  success: (res) => console.log(res.path)
})

// 裁剪成正方形
crop({ src: photoPath, ratio: 1, success: (res) => console.log(res.path) })

// 旋转 90 度
rotate({ src: photoPath, degrees: 90, success: (res) => console.log(res.path) })

API

方法 说明
addTextWatermark(options) 文字水印:内容/字号/颜色/位置(5 种+全屏平铺)/背景色/边距/透明度/角度/间距
addImageWatermark(options) 图片水印:水印图/位置/缩放/透明度
crop(options) 裁剪:按比例(如 1 正方形、1.777 为 16:9)或指定宽高
rotate(options) 旋转:90/180/270 度
getImageInfo(options) 图片信息:宽高/大小/格式
diagnose(options) 能力诊断:是否支持/系统版本

水印位置

position 效果
topLeft / topRight / bottomLeft / bottomRight 单条水印贴在对应角,可配 bgColor 底色块
center 画面正中单条水印
fullscreen 整图斜向平铺,自动覆盖四角与边缘,奇数行错开半格

全屏模式的三个要点:

  1. 自动覆盖完整:以图片中心为旋转中心,绘制范围按对角线扩展,倾斜后四角不会有空白。
  2. 不画背景块:bgColor 在全屏模式下忽略,避免整图被底色盖住;改用“白字 + 半透明黑描边”,浅色底和深色底都能看清。
  3. 透明度叠加:最终 alpha = color 自带 alpha × alpha 参数,所以 color:'#80FFFFFF' + alpha:0.5 实际约为 25%。

能力边界

  • 水印/裁剪/旋转在 Android 端功能完整;鸿蒙端水印需适配 Drawing Canvas,当前降级调用会返回失败(不会伪造成功)
  • 源图支持本地路径与 content:// Uri;写入目录默认应用缓存目录(可通过 output 指定)
  • 最低支持 Android 5.0(API 21),低于此版本 diagnose() 返回 supported=false

更新记录

1.0.0(2026-11-19)

  • 首发:文字水印、图片水印、裁剪、旋转、图片信息、诊断
  • 鸿蒙端图片信息/裁剪/旋转尽力实现,水印诚实降级

隐私、权限声明

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

读取源图片需应用具备对应文件/相册权限;最低支持 Android 5.0 (API 21)

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

插件不采集、不上传任何图片数据,所有处理均在本机完成

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

无

暂无用户评论。