### 实人认证

**平台差异说明**

|App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序、飞书小程序|QQ小程序|快手小程序|京东小程序|
|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|
|√（3.7.1+）|x|x|x|x|x|x|x|x|

### 语法

`uni.startFacialRecognitionVerify(options)`

### 参数说明

| 参数 | 类型 | 是否必传 | 支持平台 |描述 | 
|---|---|---|---|---|
| certifyId | String | 是 | 安卓、iOS |认证流水号，由服务端根据接入的业务模式调用对应的初始化接口获取  |
| progressBarColor | String | 否  | 安卓、iOS | 刷脸圈的颜色 |
| activityIndicatorColor | String | 否  | iOS | 网络等待菊花颜色 |
| progressBarBackgroundColor | String | 否  | 安卓 | 刷脸圈的背景颜色 |
| quitAlertTitle | String | 否  | 安卓 | 刷脸页退出对话框的标题 |
| quitAlertMessage | String | 否  | 安卓 | 刷脸页退出对话框的内容 |
| timeoutAlertTitle | String | 否  | 安卓 | 刷脸页超时对话框的标题 |
| timeoutAlertMessage | String | 否  | 安卓 | 刷脸页超时对话框的内容 |
| failAlertTitle | String | 否  | 安卓 | 刷脸页错误提示对话框的标题 |
| failAlertMessage | String | 否  | 安卓 | 刷脸页错误提示对话框的内容 |
| title | String | 否  | 安卓 | 刷脸圈的颜色 |
| success | String | 否  | 安卓、iOS | 成功回调 |
| fail | String | 否  | 安卓、iOS | 失败回调 |
| complete | String | 否  | 安卓、iOS | 完成回调 |


注: 颜色值为六位十六进制字符串("#FF0000")

### 返回值

|参数|描述|
|---|---|
|errSubject	| 模块名称(uni-facialRecognitionVerify)|
|errCode|错误码(详情见下表)|
|errMsg|错误信息(详情见下表)|
|cause|SDK返回的原始数据 (certifyId不为空时返回)|

#### cause

|参数|描述|
|---|---|
|code	| 原始错误码|
|message|原始错误信息|

### 错误码

|错误码|信息|描述|
|---|---|---|
|0|刷脸完成|实际结果需要通过服务端查询接口|
|10001|certifyId 不能为空 |参数 certifyId 为空|
|10010| 刷脸异常|刷脸异常,具体原因详见cause|
|10011|验证中断 |如用户主动退出、验证超时等,具体原因详见cause|
|10012|网络异常 |网络异常 |
|10013|刷脸验证失败 |实际结果需要通过服务端查询结果|
|10020|设备设置时间异常 |设备设置时间异常，仅iOS返回|