更新记录

1.0.1（2026-03-13）

修改文档

1.0.0（2026-03-13）

首次上传

平台兼容性

云端兼容性

云函数类插件通用教程

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

图片特效服务 API 文档

🚨 重要提示

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

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

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

兼容性说明

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

方法列表

1. 图片模糊

方法名
blur(params)

请求参数

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

返回结果

{
  code: Number,        // 200=成功
  message: String,     // 结果描述
  success: Boolean,    // 成功标识
  timestamp: Number,   // 时间戳
  data: {
    base64: String,    // 处理后的Base64数据
    format: String,    // 图片格式
    quality: Number    // 图片质量
  }
}

2. 图片动态模糊效果

方法名
motionBlur(params)

请求参数

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

3. 图片灰度图

方法名
grayscale(params)

请求参数

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

4. 图片锐化

方法名
sharpen(params)

请求参数

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

5. 图片透明度

方法名
opacity(params)

请求参数

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

6. 图片复古深褐色滤镜

方法名
sepia(params)

请求参数

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

7. 图片鱼眼镜头效果

方法名
fisheye(params)

请求参数

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

8. 图片光影与合成效果

方法名
shadow(params)

请求参数

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

9. 图片翻转

方法名
flip(params)

请求参数

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

10. 图片旋转

方法名
rotate(params)

请求参数

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

11. 图片对比度调整

方法名
contrast(params)

请求参数

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

12. 图片亮度调整

方法名
brightness(params)

请求参数

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

13. 图片饱和度调整

方法名
saturation(params)

请求参数

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

14. 图片反转效果

方法名
invert(params)

请求参数

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

15. 图片像素化效果

方法名
pixelate(params)

请求参数

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

16. 图片马赛克效果

方法名
mosaic(params)

请求参数

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

17. 图片素描效果

方法名
sketch(params)

请求参数

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

18. 图片卡通效果

方法名
cartoon(params)

请求参数

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

19. 图片浮雕效果

方法名
emboss(params)

请求参数

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

20. 图片发光效果

方法名
glow(params)

请求参数

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

21. 图片波浪效果

方法名
wave(params)

请求参数

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

22. 图片镜像效果

方法名
mirror(params)

请求参数

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

23. 图片拼图效果

方法名
puzzle(params)

请求参数

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

24. 图片3D效果

方法名
threeD(params)

请求参数

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

25. 图片老化效果

方法名
oldify(params)

请求参数

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

26. 图片黑白漫画效果

方法名
comic(params)

请求参数

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

27. 图片分屏效果

方法名
splitScreen(params)

请求参数

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

28. 图片万花筒效果

方法名
kaleidoscope(params)

请求参数

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

方法调用示例

示例1：图片模糊效果

const imageProcessor = uniCloud.importObject('imageProcessor-gsz')

const res = await imageProcessor.blur({
  url: 'https://example.com/source.jpg',
  blurAmount: 10,
  quality: 80
})

if (res.success) {
  console.log('图片模糊处理成功')
  console.log('处理后base64:', res.data.base64)
}

示例2：图片锐化效果

const imageProcessor = uniCloud.importObject('imageProcessor-gsz')

const res = await imageProcessor.sharpen({
  url: 'https://example.com/source.jpg',
  sharpenAmount: 15,
  quality: 85
})

if (res.success) {
  console.log('图片锐化处理成功')
  console.log('处理后base64:', res.data.base64)
}

示例3：图片透明度调整

const imageProcessor = uniCloud.importObject('imageProcessor-gsz')

const res = await imageProcessor.opacity({
  url: 'https://example.com/source.jpg',
  opacity: 0.3,
  quality: 90
})

if (res.success) {
  console.log('图片透明度调整成功')
  console.log('处理后base64:', res.data.base64)
}

关键特性说明

1. 图片格式支持

• 输入格式：JPEG、PNG
• 输出格式：JPG（默认）、PNG（当图片有透明度时）

2. 质量参数说明

• 范围：1-100，整数
• 默认值：75
• 推荐值：
  • 高质量输出：80-100
  • 平衡质量与大小：60-80
  • 低质量高压缩：1-60

3. 透明度参数说明

• 范围：0-1，浮点数
• 默认值：0.5
• 推荐值：
  • 完全不透明：1
  • 半透明：0.5
  • 几乎透明：0.1

4. 模糊参数说明

• 范围：0-100，整数
• 默认值：5
• 推荐值：
  • 轻微模糊：1-10
  • 中等模糊：10-30
  • 强烈模糊：30-100

错误码说明

常见问题（FAQ）

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

Q：图片处理后质量如何？
A：支持通过quality参数控制输出质量，范围1-100，默认75。

Q：如何调整图片透明度？
A：通过设置opacity参数（0-1）来调整图片透明度。

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，由于传输层还有上下文环境信息，所以开发者给云对象发送参数时需注意控制参数体积。

Q：为什么设置透明度后没有效果？
A：如果输入图片是JPG格式，会先转换为PNG格式以支持透明度，处理后会返回PNG格式的图片。

Q：鱼眼效果为什么只有上部分有效果？
A：已经修复了鱼眼效果的算法问题，现在整个图片都会应用鱼眼效果。

Q：锐化效果为什么不明显？
A：锐化效果可以通过调整sharpenAmount参数来控制，范围0-100，值越大效果越明显。

Q：光影效果为什么不明显？
A：光影效果可以通过调整shadowAmount参数来控制，范围0-1，值越大效果越明显。