更新记录

1.0.2（2026-03-12）

修改文档

1.0.1（2026-03-12）

修改文档

1.0.0（2026-03-12）

首次发布

平台兼容性

云端兼容性

云函数类插件通用教程

使用云函数类插件的前提是：使用HBuilderX 2.9+

图片水印服务 API 文档

🚨 重要提示

请您先试用再购买！
在正式购买前，请务必点击页面上的 "导入插件并试用" 按钮进行充分测试。
本插件由开发者利用业余时间开发维护，可能存在以下情况：

• 功能兼容性：请确认插件完全满足您的项目需求
• 问题响应：Bug修复可能无法做到即时响应
• 支持限制：优先处理已确认购买的正式用户问题

强烈建议：在试用环境中全面测试后，确认功能满足需求再进行购买！
感谢您的理解与支持 🙏

兼容性说明

本云对象服务全面兼容以下平台和框架：

方法列表

1. 图片水印

方法名
addImageWatermark(params)

请求参数

注意：原始图片和水印图片格式必须是png/jpg/jpeg。

返回结果

{
  code: Number,        // 200=成功
  message: String,     // 结果描述
  success: Boolean,    // 成功标识
  timestamp: Number,   // 时间戳
  data: {
    image: String,            // 加水印后的Base64数据
  }
}

2. 文字水印

方法名
addTextWatermark(params)

请求参数

注意：原始图片格式必须是png/jpg/jpeg。文字水印内容只支持0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ!№;%:?*()_+-=.,/|"'@#$^&{}[]<>\《》，。【】；‘·～

返回结果

{
  code: Number,        // 200=成功
  message: String,     // 结果描述
  success: Boolean,    // 成功标识
  timestamp: Number,   // 时间戳
  data: {
    image: String,            // 加水印后的Base64数据
  }
}

方法调用示例

示例1：添加图片水印

const watermarkService = uniCloud.importObject('watermark-gsz')

const res = await watermarkService.addImageWatermark({
  sourceImage: 'https://example.com/source.jpg',
  watermarkImage: 'https://example.com/watermark.png',
  x: 100,
  y: 100,
  opacity: 50
})

if (res.success) {
  console.log('图片水印添加成功')
  console.log('加水印后base64:', res.data.base64)
}

示例2：添加文字水印

const watermarkService = uniCloud.importObject('watermark-gsz')

const res = await watermarkService.addTextWatermark({
  sourceImage: 'https://example.com/source.jpg',
  text: '版权所有',
  fontSize: 16,
  color: '#FF0000',
  opacity: 80
})

if (res.success) {
  console.log('文字水印添加成功')
  console.log('加水印后base64:', res.data.base64)
}

关键特性说明

1. 水印位置智能处理

• 边界检查：水印位置自动调整，防止超出图片范围
• 相对位置：支持相对于图片边缘的位置计算

处理规则：

• 当x/y超出图片范围时，自动调整到合理位置
• 支持负数坐标，表示从图片边缘向内偏移

2. 图片格式支持

• 输入格式：JPEG、PNG
• 输出格式：JPG

3. 透明度参数说明

• 范围：1-100，整数
• 默认值：100（完全不透明）
• 推荐值：
  • 明显水印：80-100
  • 半透明水印：50-70
  • 隐形水印：10-30

4. 文字水印特性

• 颜色支持：支持任意十六进制颜色
• 加粗支持：支持文字加粗
• 换行处理：自动处理文字换行，确保不超出图片宽度

错误码说明

常见问题（FAQ）

Q：支持哪些图片格式？
A：目前支持JPEG、PNG。

Q：水印位置超出图片范围怎么办？
A：服务会自动调整水印位置，确保不超出图片范围。

Q：文字水印如何换行？
A：服务会自动处理文字换行，确保不超出图片宽度。

Q：如何添加半透明水印？
A：通过设置opacity参数（1-100）来调整水印透明度。

Q：批量处理水印是否支持？
A：目前不支持批量处理，建议循环调用单张处理接口。

Q：水印处理超时怎么办？
A：原始图片越大所需要的处理时间越长；请自行配置云对象的超时时间、函数执行内存等。

Q：如何判断水印添加成功？
A：返回结果中success字段为true表示处理成功，同时会返回加水印后的Base64数据。

Q：压缩后的图片可以直接上传到云存储吗？
A：服务返回的是Base64，需要前端自行调用uniCloud.uploadFile上传到云存储。

Q：Base64格式如何传递？
A：支持纯base64字符串和data URL格式（如data:image/jpeg;base64,...）。

Q：数据太大云对象有限制？
A：云对象的接收参数的体积上限，支付宝云接收参数大小不可超过6MB，阿里云接收参数大小不可超过2MB，腾讯云接收参数大小不可超过5MB，由于传输层还有上下文环境信息，所以开发者给云对象发送参数时需注意控制参数体积。