更新记录

0.4.49(2026-08-04)

  • 本地照片支持从 zoo-media-picker、宿主适配器或 Android/iOS 系统相册选择;选中后由原生处理器按当前模板、位置、大小和透明度自动输出成片,取消则返回相机。
  • 新增运行时 JSON 配置与 configureWatermarkCamera:可设置本地选择器通道、原生相册回退、主题、水印默认值、前后摄、倍率和闪光灯。
  • zoo-media-picker 未注册或调用失败时会明确提示并自动回退系统相册,不中断本次选择流程。
  • 设置面板新增“保留原图 / 保留原视频”;开启时回调按 [原始文件, 水印成片] 返回,且通过 resultType 区分。
  • 完善相册、旋转、录像、视频导出与本地照片处理的分阶段诊断日志,便于真机定位问题。

平台兼容性

uni-app(3.99)

Vue2 Vue2插件版本 Vue3 Vue3插件版本 Chrome Safari app-vue app-vue插件版本 app-nvue app-nvue插件版本 Android Android插件版本 iOS iOS插件版本 鸿蒙
1.0.0 0.4.49 - - 0.4.49 0.4.49 5.0 0.4.49 12 0.4.49 ×
微信小程序 微信小程序插件版本 支付宝小程序 支付宝小程序插件版本 抖音小程序 抖音小程序插件版本 百度小程序 百度小程序插件版本 快手小程序 快手小程序插件版本 京东小程序 京东小程序插件版本 鸿蒙元服务 鸿蒙元服务插件版本 QQ小程序 QQ小程序插件版本 飞书小程序 飞书小程序插件版本 小红书小程序 小红书小程序插件版本 快应用-华为 快应用-联盟
0.4.49 0.4.49 0.4.49 0.4.49 0.4.49 0.4.49 0.4.49 0.4.49 0.4.49 0.4.49 × ×

uni-app x(3.99)

Chrome Safari Android iOS 鸿蒙 微信小程序
- - - - - -

其他

多语言 暗黑模式 宽屏模式
×

水印相机(拍照/录像实时水印 + 模板 + 编辑)

自绘相机预览,水印卡片实时叠加、所见即所得;按快门把水印烧进照片像素,落盘即可直接 uni.uploadFile

当前版本:0.4.49。详细接入、配置、权限和真机验收说明见仓库根目录 README.mdTEST.md

  • 内置多种水印版式,也支持宿主通过接口传入模板样式与字段,插件负责渲染。
  • 字段级权限:拍摄时间、地点等可按接口设置为不可修改(防篡改),自定义字段可自由编辑。
  • 水印可在独立取景区内拖动,底部快门控制台不会被水印遮挡。
  • watermark.scale / opacity 可按接口参数统一控制整个水印的大小和透明度。
  • 原生模板面板内置 5 种版式,支持分组、分类、实时缩略图与无水印拍摄。
  • Android CameraX / iOS AVFoundation 双端原生实现,零第三方图像库依赖。
  • 双端支持带水印视频录制;本地照片可从 zoo-media-picker 或系统相册选取,并在原生处理器中按当前水印配置自动输出成片;关闭“展示水印”时输出原图副本。
  • 提供 JSON 配置中心、按钮下方紧凑设置面板、相机内地址选择面板、横竖屏稳定取景,以及保留原图/原视频的双文件回调。

相机、麦克风、位置权限由宿主 App 自行声明,插件运行时申请;缺失时优雅报错,不会崩溃。

详细接入方式见插件文档。

隐私、权限声明

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

相机权限由宿主 App 自行声明,插件运行时申请:Android 需 CAMERA,带声音录像需 RECORD_AUDIO,设备定位需 ACCESS_FINE_LOCATION/ACCESS_COARSE_LOCATION;iOS 需 NSCameraUsageDescription,带声音录像需 NSMicrophoneUsageDescription,设备定位需 NSLocationWhenInUseUsageDescription,iOS 13 及以下原生相册兜底需 NSPhotoLibraryUsageDescription。定位权限缺失时可手动输入地址,其他能力缺失时插件优雅提示或降级。

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

插件不采集、不上传任何数据,不请求或连接业务服务器。照片与视频处理均在设备本地完成,结果仅写入宿主 App 自身临时目录,是否上传由宿主应用决定。

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

暂无用户评论。