Skip to main content
Version: 3.x

Taro.faceDetect(option)

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

支持情况:

参考文档

类型

(option: Option) => Promise<TaroGeneral.CallbackResult>

参数

参数类型
optionOption

Option

参数类型默认值必填说明
frameBufferArrayBuffer图像像素点数据,每四项表示一个像素点的 RGBA
widthnumber图像宽度
heightnumber图像高度
enablePointbooleanfalse是否返回当前图像的人脸(106 个点)
enableConfbooleanfalse是否返回当前图像的人脸的置信度(可表示器官遮挡情况)
enableAnglebooleanfalse是否返回当前图像的人脸角度信息
enableMultiFacebooleanfalse是否返回多张人脸的信息
complete(res: TaroGeneral.CallbackResult) => void接口调用结束的回调函数(调用成功、失败都会执行)
fail(res: TaroGeneral.CallbackResult) => void接口调用失败的回调函数
success(res: SuccessCallbackOption) => void接口调用成功的回调函数

SuccessCallbackOption

参数类型必填说明
faceInfoface多人模式(enableMultiFace)下的人脸信息,每个对象包含上述其它属性

face

参数类型说明
detectRectdetectRect脸部正方框数值,对象包含 height, weight, originX, originY 四个属性
xnumber脸部中心点横坐标,检测不到人脸则为 -1
ynumber脸部中心点纵坐标,检测不到人脸则为 -1
pointArraypoint[]人脸 106 个点位置数组,数组每个对象包含 x 和 y
confArrayconf[]人脸置信度,取值范围 [0, 1],数值越大置信度越高(遮挡越少)
angleArrayangle[]人脸角度信息,取值范围 [-1, 1],数值越接近 0 表示越正对摄像头

detectRect

脸部正方框数值

参数类型
heightnumber
weightnumber
originXnumber
originYnumber

point

参数类型
xnumber
ynumber

conf

参数类型说明
globalnumber整体可信度
leftEyenumber左眼可信度
rightEyenumber右眼可信度
mouthnumber嘴巴可信度
nosenumber鼻子可信度

angle

参数类型说明
pitchnumber仰俯角(点头)
yawnumber偏航角(摇头)
rollnumber翻滚角(左右倾)