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