# wx.faceDetect(Object object)
该接口已停止维护,推荐使用 wx.createVKSession 代替
基础库 2.18.0 开始支持,低版本需做兼容处理。
以 Promise 风格 调用:不支持
# 功能描述
人脸检测,使用前需要通过 wx.initFaceDetect 进行一次初始化,推荐使用相机接口返回的帧数据。本接口不再维护,请使用 wx.createVKSession 接口代替。详情参考人脸检测指南文档
# 参数
# Object object
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
frameBuffer | ArrayBuffer | 是 | 图像像素点数据,每四项表示一个像素点的 RGBA | |
width | number | 是 | 图像宽度 | |
height | number | 是 | 图像高度 | |
enablePoint | boolean | false | 否 | 是否返回当前图像的人脸(106 个点) |
enableConf | boolean | false | 否 | 是否返回当前图像的人脸的置信度(可表示器官遮挡情况) |
enableAngle | boolean | false | 否 | 是否返回当前图像的人脸角度信息 |
enableMultiFace | boolean | false | 否 | 是否返回多张人脸的信息 |
success | function | 否 | 接口调用成功的回调函数 | |
fail | function | 否 | 接口调用失败的回调函数 | |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
# object.success 回调函数
# 参数
# Object res
属性 | 类型 | 说明 | |||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
detectRect | Object | 脸部方框数值,对象包含 height, width, originX, originY 四个属性 (origin 为方框左上角坐标) | |||||||||||||||||||||||||
x | number | 脸部中心点横坐标,检测不到人脸则为 -1 | |||||||||||||||||||||||||
y | number | 脸部中心点纵坐标,检测不到人脸则为 -1 | |||||||||||||||||||||||||
pointArray | Array.<Object> | 标记人脸轮廓的 106 个点位置数组,数组每个对象包含 x 和 y | |||||||||||||||||||||||||
confArray | Object | 人脸置信度,取值范围 [0, 1],数值越大置信度越高(遮挡越少) | |||||||||||||||||||||||||
| |||||||||||||||||||||||||||
angleArray | Object | 人脸角度信息,取值范围 [-1, 1],数值越接近 0 表示越正对摄像头 | |||||||||||||||||||||||||
| |||||||||||||||||||||||||||
faceInfo | Array.<Object> | 多人模式(enableMultiFace)下的人脸信息,每个对象包含上述其它属性 |
# 特别说明
若小程序人脸识别功能涉及采集、存储用户生物特征(如人脸照片或视频、身份证和手持身份证、身份证照和免冠照等),此类型服务需使用微信原生人脸识别接口。