# wx.requestFacialRecognition(Object object)
基础库 3.11.2 开始支持,低版本需做兼容处理。
以 Promise 风格 调用:不支持
微信 Windows 版:支持
微信 Mac 版:支持
# 功能描述
发起人脸识别验证,用于对可疑用户进行身份验证和防沉迷检查。该接口会调起微信的人脸识别系统,验证用户身份以确保游戏安全和合规性。
# 参数
# Object object
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| success | function | 否 | 接口调用成功的回调函数 | |
| fail | function | 否 | 接口调用失败的回调函数 | |
| complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
# 错误
| 错误码 | 错误信息 | 说明 |
|---|---|---|
| 0 | 人脸识别成功 | |
| 2002004 | 人脸识别失败 | |
| 2002006 | 用户取消/超时/不同意,导致未完成人脸识别 | |
| 2002007 | 本用户7天内人脸识别已通过,通过日期为XX | |
| 2002008 | 本日已调起过人脸识别 | or本月调用次数已达上限 |
| 2002009 | 无权限发起人脸识别 |
# 处理流程
- 开发者调用
wx.requestFacialRecognition发起人脸识别。 - 系统根据策略判定是否需要展示授权弹窗。
- 若判定为"不展示弹窗":立即回调结果,示例:
{ errCode: 0, errMsg: '本用户7天内人脸识别已通过' } - 若判定为"需展示弹窗":进入步骤 3。
- 若判定为"不展示弹窗":立即回调结果,示例:
- 系统展示授权弹窗。
- 玩家拒绝:立即回调
fail,errCode = 2002006 - 玩家同意:进入步骤 4。
- 玩家拒绝:立即回调
- 系统开始进行人脸识别验证
- 玩家在跳转页面中完成活体/人脸识别;关闭页面返回游戏。
- 系统回调最终识别结果返回
# 示例代码
wx.requestFacialRecognition({
success(res) {
// 人脸识别通过或 7 天内已通过
// 形如:{ errCode: 0, errMsg: 'ok' }
console.log('requestFacialRecognition success:', res)
},
fail(err) {
// 失败或受限等场景
console.log('requestFacialRecognition fail:', err)
},
complete(res) {
// 无论成功失败均会触发
console.log('requestFacialRecognition complete:', res)
}
})