wx.faceDetect(Object object)

基础库 2.18.0 开始支持,低版本需做兼容处理

Promise 风格 调用:不支持

小程序插件:不支持

人脸识别,使用前需要通过 wx.initFaceDetect 进行一次初始化,推荐使用相机接口返回的帧数据

参数

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, weight, originX, originY 四个属性
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)下的人脸信息,每个对象包含上述其它属性

res.confArray 的结构

属性 类型 说明
global number 整体可信度
leftEye number 左眼可信度
rightEye number 右眼可信度
mouth number 嘴巴可信度
nose number 鼻子可信度

res.angleArray 的结构

属性 类型 说明
pitch number 仰俯角(点头)
yaw number 偏航角(摇头)
roll number 翻滚角(左右倾)