更新记录

1.0.0（2026-04-22）

• 统一的预览区与结果区
• 水印信息示例数据填充
• Android / iOS 都走原生预览组件抓图 + 本地水印渲染链路
• 最近一次原图 / 水印图结果展示

平台兼容性

uni-app(4.75)

uni-app x(4.75)

austin-wmcam

austin-wmcam 是一个水印相机 UTS 插件，面向巡检、工程、外勤、留痕等 B 端场景。

典型场景：

• 巡检拍照自动叠加时间、地点、人员、任务信息
• 工程整改、交付验收、设备巡查留痕
• 先拍原图，再在本地生成正式水印图
• 业务侧自行传入地点、人员、任务等字段，再交给插件渲染图片

点击试用插件

插件目录下的 index.nvue 模板页，点击试用后会按平台自动走不同链路兼容安卓 IOS：

• 当前平台能力展示
• 统一的预览区与结果区
• 示例数据填充
• Android / iOS 都走原生预览组件抓图 + 本地水印渲染链路
• 最近一次原图 / 水印图结果展示

功能

• 支持 getWatermarkCameraCapabilities() 查询当前平台能力
• 支持 Android captureWatermarkPhoto() 系统拍照链路
• 支持 Android / iOS renderWatermarkPhoto() 本地图片水印渲染
• 返回统一结果结构：原图路径、水印图路径、尺寸、时间戳、字段快照
• index.nvue 已作为 Android / iOS 统一试用入口

getWatermarkCameraCapabilities()

返回当前平台能力对象。

captureWatermarkPhoto(options)

拉起系统相机拍照，并在成功后返回原图与水印图。

• Android：当前版本可用；统一模板页优先走原生预览组件
• iOS：统一模板页当前走原生预览组件 + renderWatermarkPhoto()；captureWatermarkPhoto() 稳定版待补

renderWatermarkPhoto(options)

把已有图片路径交给插件，在本地生成原图与水印图。

• Android：支持
• iOS：支持

字段结构

type WatermarkFieldItem = {
  key: string
  label: string
  value: string
}

返回结果

captureWatermarkPhoto()、renderWatermarkPhoto() 使用同一套返回结构：

最小示例

import {
  captureWatermarkPhoto,
  getWatermarkCameraCapabilities,
  renderWatermarkPhoto,
} from '@/uni_modules/austin-wmcam'

const capabilities = getWatermarkCameraCapabilities()
console.log('watermark-capabilities', capabilities)

const fields = [
  { key: 'time', label: '拍摄时间', value: '2026-04-22 14:20:00' },
  { key: 'location', label: '拍摄地点', value: '上海市浦东新区张江高科技园区' },
  { key: 'user', label: '拍摄人', value: 'Austin' },
  { key: 'task', label: '任务点位', value: '消防通道' },
]

captureWatermarkPhoto({
  title: '工程巡检',
  fields,
  success(res) {
    console.log('watermark-capture-success', res)
  },
  fail(res) {
    console.log('watermark-capture-fail', res)
  },
})

renderWatermarkPhoto({
  imagePath: 'file:///storage/emulated/0/Android/data/xxx/cache/preview.jpg',
  title: '工程巡检',
  fields,
  success(res) {
    console.log('watermark-render-success', res)
  },
  fail(res) {
    console.log('watermark-render-fail', res)
  },
})

注意

• 水印信息完全由业务侧主动传入；
• 图片与水印图都在本地生成，不上传到任何服务器
• outputOriginal 和 outputWatermarked 不能同时为 false
• 如果业务页面使用 nvue 的 <image> 直接展示本地绝对路径图片，iOS 上建议补成 file:// 前缀，避免出现灰色占位图