更新记录
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 |
整图斜向平铺,自动覆盖四角与边缘,奇数行错开半格 |
全屏模式的三个要点:
- 自动覆盖完整:以图片中心为旋转中心,绘制范围按对角线扩展,倾斜后四角不会有空白。
- 不画背景块:
bgColor 在全屏模式下忽略,避免整图被底色盖住;改用“白字 + 半透明黑描边”,浅色底和深色底都能看清。
- 透明度叠加:最终 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)
- 首发:文字水印、图片水印、裁剪、旋转、图片信息、诊断
- 鸿蒙端图片信息/裁剪/旋转尽力实现,水印诚实降级