x-photokit-s 图片水印

给图片加多行文字水印，支持 5 个位置、压缩和安全边距。

兼容性

Harmony	IOS	Android	WEB	小程序
支持	支持	支持	支持	支持

调用

import { addWaterMark } from "@/uni_modules/x-photokit-s"

addWaterMark({
  path: imagePath,
  opts: {
    text: ["ID4656s5fsdf", "编号图片的位置xx", "广东省上海路699号江杨区域"],
    color: "rgba(32, 36, 255, 1.0)",
    fontSize: 12,
    position: "center",
    compress: 100,
    prefix: "tmx-",
    lineSpace: 3,
    safeOffset: 10
  },
  success: (res) => {
    uni.previewImage({ urls: [res.detail], current: res.detail })
  }
})

方法

名称	需要	说明
addWaterMark	path、opts，可选 success	给图片加水印，成功 res.detail 为输出路径

参数

xPhotokitSOpts

字段	说明	默认
path	图片路径	必填
opts	水印配置	必填
success	成功，res.detail 为输出路径	-
fail	失败	-
complete	结束	-

XPHOTOKIT_ADDWATERMARK_OPTS

字段	说明	默认
text	多行文字	[]
fontSize	字号，会按图片尺寸缩放	12
color	颜色，支持 rgb / rgba / Hex / HSL	#ffffff
position	topLeft / topRight / bottomLeft / bottomRight / center	center
compress	压缩 0~100，100 不压缩	100
prefix	输出文件名前缀	时间戳
lineSpace	行间距	0
safeOffset	距边安全距离	0
webOutFileType	Web 输出：base64 或 Blob	base64

平台差异

1. Web 可用 webOutFileType 控制返回 base64 或 Blob。

版本

版权归https://xui.tmui.design你不得修改及二次开发，仅供TMUI4会员商用使用。不得转给非VIP会员使用，一经查实数倍赔偿，并追究法律责任。

更新日志

1.0.0（2025-10-15）

• 针对鸿蒙的兼容,优化web和微信。
• 针对不同图片大小，智能缩放字号大小让字号不过大也不过小。