易盾验证码用户使用文档--字节跳动小程序版

引入

在根目录执行下述命令

  npm install @yidun/tt-ne-captcha

使用

1. 引用声明组件，在页面或组件的json文件中声明

{
  "usingComponents": {
    "ne-captcha": "path-to-component/ne-captcha/index"
  }
}

2. 使用组件

<view>
  <ne-captcha
    id="neCaptcha"
    captcha-id="yourCaptchaID"
    width="640rpx"
    bindverify="handleVerify"></ne-captcha>
  <view>
    <button bindtap="openCaptcha">点击验证</button>
  </view>
</view>

Page({
  handleVerify (ev) {
    if (ev.detail[0]) {
      // 验证失败
      return
    }
    
    // TODO: 验证成功
    console.log(ev.detail[1])
  },
  openCaptcha () {
    this.selectComponent('#neCaptcha', res => {
      res && res.popup()
      // 智能无感知请调用 res.verify()
    })
  }
})

属性

| 可配项 | 类型 | 默认值 | 描述 | |--------|-------|----------|-------| | captchaId | String | 无 | 验证码ID | | lang | String | 'zh-CN' | 语言 | | width | String | 'auto' | 验证码弹框宽度，接受单位'rpx'/'px'/'rem'/'%' | | captchaType | String | 无 | 配置验证码类型 | | customStyles | Object | null | 自定义验证码样式，包含imagePanel/controlBar/gap/popTitle/popPadding,详情查看下面 |

**注意：**小程序的超时设置可在app.json全局配置

customStyles

• imagePanel
  • borderRadius（String）: imagePanel的圆角大小
• controlBar
  • borderRadius（String）: controlBar的圆角大小
  • height（String）: controlBar的高度
• gap: imagePanel和controlBar的间隔
• popTitle
  • height（String）: 弹框头部高度
• popPadding（String）: 弹框体内边距

事件

| 事件名 | 参数 | 描述 | |-------|------|------| | error | 无 | 验证码配置失败 | | init | 无 | 验证码配置成功（初始化）| | ready | 无 | 验证码准备就绪 | | verify | err,validate | 验证码验证完成 | | close | 无 | 验证码弹框准备关闭 |

组件方法

popup: 展示验证码 reset: 重置验证码，获取新的验证信息 verify: 智能无感知验证码进行验证 getCaptchaType: 获取验证码类型

域名

1. 服务器域名：c.dun.163yun.com、c.dun.163.com
2. 图片域名：necaptcha.nosdn.127.net、nos.netease.com