wx.faceDetect

wx.faceDetect(Object object)

该接口已停止维护，推荐使用 wx.createVKSession 代替

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

以 Promise 风格 调用：不支持

小程序插件：支持，需要小程序基础库版本不低于 2.21.3

功能描述

人脸检测，使用前需要通过 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.	标记人脸轮廓的 106 个点位置数组，数组每个对象包含 x 和 y
	confArray	Object	人脸置信度，取值范围 [0, 1]，数值越大置信度越高（遮挡越少）
	结构属性类型说明globalnumber整体可信度leftEyenumber左眼可信度rightEyenumber右眼可信度mouthnumber嘴巴可信度nosenumber鼻子可信度
	angleArray	Object	人脸角度信息，取值范围 [-1, 1]，数值越接近 0 表示越正对摄像头
	结构属性类型说明pitchnumber仰俯角（点头）yawnumber偏航角（摇头）rollnumber翻滚角（左右倾）
	faceInfo	Array.	多人模式（enableMultiFace）下的人脸信息，每个对象包含上述其它属性

特别说明

若小程序人脸识别功能涉及采集、存储用户生物特征（如人脸照片或视频、身份证和手持身份证、身份证照和免冠照等），此类型服务需使用微信原生人脸识别接口。