更新记录

1.2.8（2025-05-29） 下载此版本

iOS SDK 升级至 3.6.7

1.2.7（2025-05-24） 下载此版本

支持extra_data扩展参数配置

1.2.6（2025-01-21） 下载此版本

Android原生库修改为远程依赖，优化云端打包的兼容性

平台兼容性

原生插件通用使用流程：

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原生插件配置”->”云端插件“列表中删除该插件重新选择

行为式验证码

网易易盾 提供全新人机验证方式，高效拦截机器行为，业务安全第一道防线。搭载风险感知引擎，智能切换验证难度，安全性高，极致用户体验。读屏软件深度适配，视障群体也可轻松使用，符合工信部无障碍适配要求。

了解更多产品信息或体验试用，请访问 行为式验证码产品页。

平台支持（兼容性）

资源引入/集成

Android&iOS

从 dcloud 插件市场下载对应插件放到指定目录 nativeplugins 下，也可以直接选择云端插件打包。导入插件之后一定要自定义基座方可生效，自定义基座说明请参考 https://ask.dcloud.net.cn/article/35115

h5

在自定义模板（比如 template.h5.html）文件中引入以下脚本：

<script src="https://cstaticdun.126.net/load.min.js?t=201903281201"></script>

调用示例

Android&iOS

<template>
    <view>
        <button @click="tryToVerify">显示验证码</button>
    </view>
</template>

<script>
    export default {
        created() {
            this.initNeCaptcha()
        },
        methods: {
            initNeCaptcha() {
                this.captchaIns = uni.requireNativePlugin('YD-Captcha')
                this.captchaIns.init({
                    captcha_id: '易盾获取到的业务id',
                    is_debug: true
                })
            },
            tryToVerify() {
                this.captchaIns.showCaptcha((data)=>{
                    console.log(data);
                    var method = data.method;
                    if(method == "onSuccess"){
                        // 验证成功
                        var data = data.data;
                        console.log(data.validate);
                    }else if(method == "onError"){
                        var data = data.data;
                        console.log(data.message);
                    }
                })
            }
        }
    }
</script>

更多使用场景请参考 demo

h5

<template>
    <view>
        <view id="captcha"></view>
    </view>
</template>

<script>
    export default {
        data() {
            return {
                captchaIns: null,
                options: null
            }
        },
        created () {
            this.initNeCaptcha()
        },
        destroyed () {
            this.captchaIns = null
        },
        methods: {
            initNeCaptcha () {
                const options = {
                    // h5其他配置项请参考文档  https://support.dun.163.com/documents/15588062143475712?docId=294963751458885632
                    captchaId: '向易盾申请的 captchaId',
                    element: '#captcha',
                    protocol: 'https',
                    onVerify: (err, data) => {
                        console.log(err, data)
                    }
                }
                if (this.isSense) {
                    options.mode = 'bind'
                } else {
                    options.mode = 'popup'
                }

                initNECaptcha({ ...options }, ins => {
                    this.captchaIns = ins
                })
            },
            verify () {
                if (this.isSense) {
                    this.captchaIns.verify()
                } else {
                    this.captchaIns.popUp()
                }
            },
            reset () {
                this.captchaIns.refresh()
            },
            destroyCap () {
                this.captchaIns.destroy()
            },
        }
    }
</script>

h5 更多使用方式请查询文档 h5验证码接入文档，以下的文档是对于 Android & iOS 的说明。

SDK 方法说明

1. 初始化

代码说明：

const captchaIns = uni.requireNativePlugin('YD-Captcha')
captchaIns.init({
    'captcha_id': '易盾业务id',
    'styleConfig':{
        'radius': 10,
        'capBarTextColor': '#25D4D0',
        'capBarTextSize': 18,
        'capBarTextWeight': "bold",
        'borderColor': "#25D4D0",
        'borderRadius': 10,
        'backgroundMoving': '#DC143C',
        'executeBorderRadius': 10,
        'executeBackground': '#DC143C',
        'capBarTextAlign': 'center',
    }
})

options 支持的可配置项说明

language_type 多语言对应表

styleConfig 验证码UI自定义配置对应表

2. 显示验证码

代码说明：

captchaIns.showCaptcha((result)=>{})

回调说明：

{"method":"xxx","data":{xxx}}

method为验证码的各个阶段，data为各个阶段的回调

3. 销毁验证码弹窗

代码说明：

captchaIns.destroyCaptcha()