Taro.faceDetect(option)
人脸识别,使用前需要通过 Taro.initFaceDetect 进行一次初始化,推荐使用相机接口返回的帧数据
支持情况:
.default})
参考文档
类型
(option: Option) => Promise<TaroGeneral.CallbackResult>
参数
Option
| 参数 |
类型 |
默认值 |
必填 |
说明 |
| frameBuffer |
ArrayBuffer |
|
是 |
图像像素点数据,每四项表示一个像素点的 RGBA |
| width |
number |
|
是 |
图像宽度 |
| height |
number |
|
是 |
图像高度 |
| enablePoint |
boolean |
false |
否 |
是否返回当前图像的人脸(106 个点) |
| enableConf |
boolean |
false |
否 |
是否返回当前图像的人脸的置信度(可表示器官遮挡情况) |
| enableAngle |
boolean |
false |
否 |
是否返回当前图像的人脸角度信息 |
| enableMultiFace |
boolean |
false |
否 |
是否返回多张人脸的信息 |
| complete |
(res: TaroGeneral.CallbackResult) => void |
|
否 |
接口调用结束的回调函数(调用成功、失败都会执行) |
| fail |
(res: TaroGeneral.CallbackResult) => void |
|
否 |
接口调用失败的回调函数 |
| success |
(res: SuccessCallbackOption) => void |
|
否 |
接口调用成功的回调函数 |
SuccessCallbackOption
| 参数 |
类型 |
必填 |
说明 |
| faceInfo |
face |
否 |
多人模式(enableMultiFace)下的人脸信息,每个对象包含上述其它属性 |
face
| 参数 |
类型 |
说明 |
| detectRect |
detectRect |
脸部正方框数值,对象包含 height, weight, originX, originY 四个属性 |
| x |
number |
脸部中心点横坐标,检测不到人脸则为 -1 |
| y |
number |
脸部中心点纵坐标,检测不到人脸则为 -1 |
| pointArray |
point[] |
人脸 106 个点位置数组,数组每个对象包含 x 和 y |
| confArray |
conf[] |
人脸置信度,取值范围 [0, 1],数值越大置信度越高(遮挡越少) |
| angleArray |
angle[] |
人脸角度信息,取值范围 [-1, 1],数值越接近 0 表示越正对摄像头 |
detectRect
脸部正方框数值
| 参数 |
类型 |
| height |
number |
| weight |
number |
| originX |
number |
| originY |
number |
point
conf
| 参数 |
类型 |
说明 |
| global |
number |
整体可信度 |
| leftEye |
number |
左眼可信度 |
| rightEye |
number |
右眼可信度 |
| mouth |
number |
嘴巴可信度 |
| nose |
number |
鼻子可信度 |
angle
| 参数 |
类型 |
说明 |
| pitch |
number |
仰俯角(点头) |
| yaw |
number |
偏航角(摇头) |
| roll |
number |
翻滚角(左右倾) |