# 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 无权限发起人脸识别

# 处理流程

  1. 开发者调用 wx.requestFacialRecognition 发起人脸识别。
  2. 系统根据策略判定是否需要展示授权弹窗。
    • 若判定为"不展示弹窗":立即回调结果,示例:{ errCode: 0, errMsg: '本用户7天内人脸识别已通过' }
    • 若判定为"需展示弹窗":进入步骤 3。
  3. 系统展示授权弹窗。
    • 玩家拒绝:立即回调 failerrCode = 2002006
    • 玩家同意:进入步骤 4。
  4. 系统开始进行人脸识别验证
    • 玩家在跳转页面中完成活体/人脸识别;关闭页面返回游戏。
  5. 系统回调最终识别结果返回

# 示例代码

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)
  }
})
点击咨询小助手