更新记录

1.1.3(2022-03-30)

1.Android支持78种语言 2.Android默认取系统语言 3.Android支持主题和加载文案自定义

1.1.2(2021-08-18)

增加验证码关闭回调

查看更多

平台兼容性

Android iOS
适用版本区间:4.4 - 11.0 适用版本区间:9 - 15

原生插件通用使用流程:

  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
适用版本区间:4.4 - 11.0 适用版本区间:9 - 15

资源引入/集成

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

调用示例

<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_no_sense_mode: false
                }, (data) => {
                    // 成功和错误回调
                })
            },
            tryToVerify() {
                this.captchaIns.showCaptcha((data)=>{
                    // 关闭验证码弹窗回调
                })
            }
        }
    }
</script>

更多使用场景请参考 demo

SDK 方法说明

1. 初始化

代码说明:

const captchaIns = uni.requireNativePlugin('YD-Captcha')
captchaIns.init(options,(result) => {})
options 支持的可配置项说明
key value 类型 是否必填 默认值 描述
captcha_id String 易盾获取到的业务 id
failed_max_retry_count Number 3 失败后尝试最大次数,值>= 1
is_debug Boolean false 是否启动 debug 模式
is_no_sense_mode Boolean false 是否为智能无感知
dimAmount Number 0.5 验证码框遮罩层透明度
control_bar_start_url String 自定义滑块开始背景
control_bar_moving_url String 自定义滑块滑动背景
control_bar_error_url String 自定义滑块错误背景
is_touch_outside_disappear Boolean true 点击弹窗外部是否可以关闭验证码
timeout Number 10000 超时时间/ms
is_hide_close_button Boolean false 是否隐藏关闭按钮
use_default_fallback Boolean true 是否采用默认降级
language_type String 系统语言 多语言语言类型
loading_text String 智能检测中 自定义加载文案
language_type 多语言对应表

注意在 manifest.json 的 app-plus 域下配置多语言的支持

 "locales" : {
            "ja" : {},
            "ko" : {},
            xxx需要支持的多语言
        }
多语言值 说明
zh-TW 中文繁体
en 英文
ja 日语
ko 韩文
th 泰语
vi 越南语
fr 法语
ru 俄语
ar 阿拉伯语
de 德语
it 意大利语
he 希伯来语
hi 印地语
id 印尼语
my 缅甸语
lo 老挝语
ms 马来语
pl 波兰语
pt 葡萄牙语
es 西班牙语
tr 土耳其语

验证状态回调说明

captchaIns.init(options, (result) => {
    if(result.validate){
        alert('验证成功')
    }else{
        //验证失败
        //code 错误码
        //message 错误信息
        alert(result.code);
        alert(result.message);
    }
}

2. 显示验证码

代码说明:

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

3. 销毁验证码弹窗

代码说明:

captchaIns.destroyCaptcha()

隐私、权限声明

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

"<uses-permission android:name=\"android.permission.ACCESS_NETWORK_STATE\"/>", "<uses-permission android:name=\"android.permission.INTERNET\"/>", "<uses-permission android:name=\"android.permission.READ_EXTERNAL_STORAGE\"/>", "<uses-permission android:name=\"android.permission.WRITE_EXTERNAL_STORAGE\"/>"

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

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

许可协议

作者未提供license.md

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问