更新记录

5.2.0（2025-10-16）

修复上一个版本遗留的前摄摄像头拍照显示翻转的bug，优化插件对鸿蒙系统的兼容

5.1.0（2025-10-09）

优化IOS端分辨率选择，提高清晰度

5.0.5（2025-09-10）

修复安卓端某些机型偶发性发生录制视频保存后是无法打开，黑屏状态

平台兼容性

原生插件通用使用流程：

1. 购买插件，选择该插件绑定的项目。
2. 在HBuilderX里找到项目，在manifest的app原生插件配置中勾选模块，如需要填写参数则参考插件作者的文档添加。
3. 根据插件作者的提供的文档开发代码，在代码中引用插件，调用插件功能。
4. 打包自定义基座，选择插件，得到自定义基座，然后运行时选择自定义基座，进行log输出测试。
5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项：使用HBuilderX2.7.14以下版本，如果同一插件且同一appid下购买并绑定了多个包名，提交云打包界面提示包名绑定不一致时，需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择

water-mark-camera

本插件由上海栾青网络科技有限公司出品，是一款功能强大的自定义相机插件，将根据开发者需求和建议长久持续维护，可以高度自定义相机界面；丰富的API功能(拍照、录像、切换摄像头、闪光灯控制、文字水印、图片水印、标签水印等多种水印配置、自动对焦、手动对焦、镜头缩放功能)，详情可参阅示例工程。如有未满足的功能亦可联系我们进行功能升级优化、功能定制开发

可官网联系添加作者索取 体验apk

【体验apk下载】点击链接下载

特色和优势

1、支持vue2、vue3

2、全市场唯一可以实现动态视频水印的功能，所有水印均可设置为动态显示，能够实现动态时间水印，可适用于监控录制、会议记录等需要实时时间日期的场景要求

3、更加自由灵动的水印配置，可添加多个图片logo水印(可设置边框、圆角、位置等风格样式)，可自由配置文字水印内容、字号、字体颜色、边框、单行背景、圆角、位置、图标等等风格

4、功能强大，集合了拍照、录像于一体，原生代码高性能运行，可设置存储到相册/沙盒

5、使用简单，插件主页点击试用即可将插件加入项目中，然后通过打自定义基座运行即可进行插件的测验，或者直接找作者索取包含自定义基座的demo项目（因uni插件市场不运行上传包含基座的示例）

6、价格实惠，在本插件进入uni插件市场之前，原生自定义相机插件价格昂贵，高达上千元；本插件上架插件市场后，将价格打压下来，并通过基础版、增强版两个核心版本来满足不同价位需求。

极简模式在页面使用插件 （示例页面：/pages/index/camera/camera2）

    <water-mark-camera
        ref="cameraObj" 
        @onTakePhotoSuccess="onTakePhotoSuccess" // 拍照成功回调（可以获得照片路径）
        @onRecordSuccess="onRecordSuccess" // 录像成功回调（可以获得视频路径）
        @onReceiveInfo="onReceiveInfo"  // 日志信息回调
        >
    </water-mark-camera>

插件使用注意事项

插件主页点击【试用】或直接购买，之后会让您选择项目并绑定包名，这样项目中就有插件的配置了，然后需要云打包或打包自定义基座，运行自定义基座来测验功能，或者打包发布

manifest.json 中 App常用其他设置 minSdkVersion设置为23或以上

（注意：原生插件必须要在nvue的页面，nvue和vue基本功能一直，只是存在一些差异，比如css的用法等）

调用开放的API接口（拍照、录像、闪光灯开关、前后摄像头镜像切换、水印logo设置），插件本身为满足用户的不同UI设计，仅提供预览+开放API，不在原生界面上添加多余UI。

插件实现高度自由的界面自定义，用户可自行在预览界面上叠加放置其他按钮或文字（具体可参照demo项目），使用cover-view , cover-image(具体可在uniapp官网查看这两个标签的说明)覆盖到原生插件上。

如果水印要求比较低可以使用基础版插件，价格更优惠。

插播广告

公司的官方网站地址（可进行联系和定制开发）

上海栾青网络科技有限公司 https://luanqing.net

轻语API https://5555api.com

开源小程序版本的水印相机项目地址

本司提供了一些API服务轻语API，每天有免费使用量，包含二维码在线生成/地理编码解析/逆地理编码/文字生成语音/语言转文字/获取美图壁纸/企业工商信息查询/等等，如有需要可联系或定制，更多api可访问https://5555api.com

API 请求方法简要说明

请求方法参数说明

API 参数简要说明

API 回调方法监听简要说明

获取横竖屏回调监听

    this.$refs.cameraObj.addOrientationListener(res=>{
        console.error("监听到横竖屏变化：", (res.orientation === 'Landscape' ? '横屏':'竖屏'));
    })

文字水印配置参数

{
    // 水印内容风格设置
    title:"日常考勤" ,  // 水印块视图内容的标题
    width:  200,  // 宽度  px
    borderWidth: 5,  // 边框粗细 px

    // 商标小图标
    icon:{
        base64:"xxxxxxxx",
        width: 40,
        height: 40,
        position: 'left'  // 位置   left | right   设定在标题的左边还是右边
        iconCorner: 15, // 圆角值
        iconCornerLeftTop: 1, // 左上角圆是否显示  0|不显示  1|显示
        iconCornerLeftBottom: 1, // 左下角圆是否显示  0|不显示  1|显示
        iconCornerRightTop: 1, // 右上角圆是否显示  0|不显示  1|显示
        iconCornerRightBottom: 1, // 右下角圆是否显示  0|不显示  1|显示
        iconAlpha: 50, // 图标透明度
    }   

    // 水印位置风格设置
    positionHorizontal:"left",  // 水印水平方向位置 left | center | right
    positionVertical:"bottom", // 水印垂直方向位置 top | center | bottom
    offsetLeft: 0 , // 默认0，水印距离左边的偏移量（单位px）
    offsetRight: 0 , // 默认0，水印距离右边的偏移量（单位px）
    offsetTop: 0, // 默认0，水印距离顶部的偏移量（单位px）
    offsetBottom: 0, // 默认0，水印距离底部的偏移量（单位px）
    background: "#ee89ee", // 水印面板背景色, 如果要无背景色可不传此参数
    borderColor: "#eeddee",  // 边框颜色 
    corner: 15, // 圆角值
    cornerLeftTop: 1, // 左上角圆是否显示  0|不显示  1|显示
    cornerLeftBottom: 1, // 左下角圆是否显示  0|不显示  1|显示
    cornerRightTop: 1, // 右上角圆是否显示  0|不显示  1|显示
    cornerRightBottom: 1, // 右下角圆是否显示  0|不显示  1|显示

    alpha :  50, // 透明度 百分比

    // 标题内容风格设置
    titleFontSize:  16,  // 标题文字的字号 
    titleBold: 0, // 标题文本是否加粗
    titleColor: "#eeff00", // 标题文本颜色
    titleBackground: "#3f89ec" ,  // 标题文本的背景色
    titleAlign: 'center' , // 标题对齐方式 left right center
    titleAlpha: 25 , // 标题背景透明度

    content:[   //  [必传] 自定义数据，如无数据传空数组 [ ] ，不可传null或其他空类型，所有子项均可设置风格，此处举例第一项。
        {
            key: "经度",   // 如果为非空数组，此项[必传] 
            value:"122.52734°",   // 如果为非空数组，此项[必传] 
            color: "#ff33ee" , // 文本颜色  默认: #333333
            background:"#34rf32",   // 文本背景色  默认 #ffffff
            fontSize: 14,   // 文本字号  默认： 13
            alpha: 70, // 透明度  默认：0 不透明
            bold:  0 , //  文本是否加粗 1加粗  0常规， 默认0
            align: 'left' ,  // 文本对齐方式 left right center   默认：left
        },  
           {key: "纬度", value:"32.22434°"},
           {key: "地址", value:"新世纪大厦"},
           {key: "姓名", value:"XXX"}
       ]
   }

图片水印配置（可以同时配置多个）

[
    {
        base64:"xxxxxxxx",   // [必传] 图片内容
        width: 200,  // [必传] 图片宽度 单位px
        height: 200 , // [必传] 图片高度 单位px
        borderWidth: 4,  // 边框粗细 px
        positionHorizontal:"",  // 水印水平方向位置 left | center | right
        positionVertical:"", // 水印垂直方向位置 top | center | bottom
        borderColor: "#eeddee",  // 边框颜色 
        corner: 15, // 圆角值
        cornerLeftTop: 1, // 左上角圆是否显示  0|不显示  1|显示
        cornerLeftBottom: 1, // 左下角圆是否显示  0|不显示  1|显示
        cornerRightTop: 1, // 右上角圆是否显示  0|不显示  1|显示
        cornerRightBottom: 1, // 右下角圆是否显示  0|不显示  1|显示
        alpha :  20, // 透明度 百分比  0-100  0不透明 100全透明
        borderAlpha:  0,  // 透明度 百分比  0-100  0不透明 100全透明
        offsetLeft: 0 , // 默认0，水印距离左边的偏移量（单位px）
        offsetRight: 0 , // 默认0，水印距离右边的偏移量（单位px）
        offsetTop: 0, // 默认0，水印距离顶部的偏移量（单位px）
        offsetBottom: 0, // 默认0，水印距离底部的偏移量（单位px）
    }
]

标签水印配置（可以同时配置多个，android端还可用html标签控制风格，比如font字体颜色等，这是html标签文字）

[
    {
        text: " 这是一个标签 ", // 必传 标签标题
        textColor: "#ffffff",  // 文字颜色  默认#000000
        textAlign: 'center' , // left  right  center  默认center
        fontSize: 13,  // 字号  默认 14
        x: getAdaptiveValue(50), // 位置坐标 x   默认0
        y: getAdaptiveValue(20), // 位置坐标 y   默认0
        bgColor: "#E00300",  // 背景颜色  默认无
        alpha: 25, // 透明度  默认不透明
        bold: 1, // 0正常  1|加粗   默认不加粗
        radius: 4, // 圆角值   默认0
        borderWidth: 2,  //边框粗细   默认0 
        borderColor: "#007AFF"  // 边框颜色 默认无
    },
    {
      text: "这是一个蓝底白字标签"+(new Date().getTime()), // 必传 标签标题
      textColor: "#ffffff",  // 文字颜色  默认#000000
      textAlign: 'center' , // left  right  center
      fontSize: 15,
      x: getAdaptiveValue(40), // 位置坐标 x   默认0
      y: getAdaptiveValue(200), // 位置坐标 y   默认0
      bgColor: "#007AFF",  // 背景颜色  默认无
      alpha: 50, // 透明度  默认不透明
      bold: 1, // 0正常  1|加粗   默认不加粗
      radius: 12, // 圆角值   默认0
      borderWidth: 2,  //边框粗细   默认0 
      borderColor: "#999999"  // 边框颜色 默认无
    },
]

回调方法参数说明

插件使用示例：

    <!-- 相机原生插件 START -->
    <water-mark-camera
        ref="cameraObj" 
        isSave2Album="1"
        isAutoRotate="1"
        isAbleLandscape="1"
        class="camera_view"
        @onTakePhotoSuccess="onTakePhotoSuccess"
        @onRecordSuccess="onRecordSuccess"
        @onRecordFail="onRecordFail" 
        @onReceiveInfo="onReceiveInfo"
        >
    </water-mark-camera>
    <!-- 相机原生插件 END -->

    .camera_view{
        z-index: 100;
        width: 750rpx;
        height: 1330rpx;
    }

vue3可在项目根目录新建一个 vite.config.js 文件，内容如下

import {      
    defineConfig      
} from 'vite'      
import uni from '@dcloudio/vite-plugin-uni'  
const CUSTOM_TAG = ['water-mark-camera']//把自定义原生组件的名字写入到这里面  
export default defineConfig({      
    plugins: [      
        uni({      
            vueOptions: {      
                template: {      
                    compilerOptions: {  
                        isCustomElement: tag => CUSTOM_TAG.includes(tag)//这样就可以让编译器知道哪些是自定义组件  
                    }      
                }      
            }      
        })      
    ]      
})

对于需要上传的开发者，可在拍照/录像完成后在回调方法里得到照片/视频的保存路径，然后调用上传接口上传即可

上海栾青网络科技有限公司

*** (同微信)