> 文档版本:1.0.1
> 编辑时间:2021.10.10
## 盛事通App人脸识别组件说明:
1.H5端调用App的 needLiveOnly 方法拉起活体识别界面,此方法有2个可选参数如下:
cardNo:替H5暂存的身份证号,将会在调用H5的liveOnlyBestImage方法时带回
2.App端做完活体识别后,会将一张最佳活体照片的base64字符串作为参数回调
3.H5端拿到 base64 后,根据自身业务需要进行后续的开发。具体返回的参数如下:
cardNo:身份证号,H5在调用App的needLiveOnly方法中传的参数cardNo,App负责原样带回(有则返回,无则反空串)
idCardBase64:身份证正面整体照片Base64(如果前一个业务是扫身份证needCardOnly,则此参数一定有,否则为空串)
portraitBse64:身份证正面人像照片Base64(如果前一个业务是扫身份证needCardOnly,则此参数一定有,否则为空串)
liveOnlyBestImageBase64:最佳活体图Base64(一定有)
type:H5在调用sdk方法中传的参数type,App负责原样带回(有则返回,无则反空串)
错误码对照表如下:
> 1000 通用性失败错误码,不确定问题出在哪里,但就是所期望的结果未达成。
1001 用户主动取消操作,比如用户主动点击了返回按钮等用户主动中断业务流程的情况。
1002 用户未授权相关操作的系统权限,比如说询问是否可以使用手机相机的时候点击了“否”。
1003 接口错误,与此业务相关的接口,没有按照约定返回可以达成业务的返回值,导致业务处理失败。
1004 SDK错误,如果此业务需要调用相应的SDK来完成,在调用SDK的过程中出现SDK的错误会返回此错误码。
1005 用户操作不规范所导致的错误,比如说用户未按照人脸识别功能的要求做完相应的动作,导致业务无法继续的问题。
1006 App代码级别出现错误或异常导致业务无法进行。
```
const payload = {
caadNo: '210145198702319876',
type: '1'
}
this.$hdsdk.needLiveOnly(payload).then(console.log).catch(console.error)
```