更新记录

1.0（2026-01-16）

首次发布

平台兼容性

uni-app(4.36)

uts-watermarkCamera

UTS 水印相机插件（Android）。提供相机预览、时间/地址水印、拍照后预览确认（使用/重拍），返回带水印的照片路径。

安装

将插件放入项目 uni_modules/uts-watermarkCamera，HBuilderX 会自动识别。

使用方式

import { openWatermarkCamera } from "@/uni_modules/uts-watermarkCamera"

openWatermarkCamera({
  title: "相机",
  showTimeWatermark: true,
  showLocationWatermark: true,
  // location: "手动传入地址（可选，优先级高于定位）",
  success: (res) => {
    console.log("路径:", res.tempFilePath)
    console.log("时间:", res.watermarkTime)
  },
  fail: (err) => {
    console.log("失败:", err.errMsg)
  }
})

参数说明

openWatermarkCamera(options)

• title：标题，默认“相机”
• showTimeWatermark：是否显示时间水印，默认 true
• showLocationWatermark：是否显示地址水印，默认 true
• location：手动传入地址（可选），若传入将优先显示该地址
• success：成功回调
• fail：失败回调
• complete：完成回调

返回值

success(res)

• tempFilePath：照片本地路径
• watermarkTime：水印时间（HH:mm）

预览流程

拍照完成后进入预览页面：

• 使用：返回路径并关闭相机
• 重拍：删除刚拍摄的照片并回到相机

权限

• android.permission.CAMERA
• android.permission.ACCESS_FINE_LOCATION（地址水印）
• android.permission.ACCESS_COARSE_LOCATION（地址水印）