抖音开放平台Logo
开发者文档
控制台

DetectData
收藏
我的收藏

DetectData 是描述人脸关键信息的对象,通过 Detector.detectFaces(Video) 方法创建,在 Detector 的监听函数中可以被拦截获取。

实例属性

属性名类型说明
idnumber人脸标识
scorenumber识别置信度,取值范围为 0 到 1
boundingBoxobject人脸包围盒
actionsArray[string]]面部动作
faceArray[object]面部轮廓关键点 33 个,每个点的值为坐标(x,y)
leftEyeArray[object]左眼睛关键点 9 个 ,每个点的值为坐标(x,y)
leftEyebrowArray[object]左眉毛关键点 9 个 ,每个点的值为坐标(x,y)
noseArray[object]鼻子关键点 15 个 ,每个点的值为坐标(x,y)
mouthArray[object]嘴巴关键点 20 个 ,每个点的值为坐标(x,y)
rightEyeArray[object]右眼睛关键点 9 个 ,每个点的值为坐标(x,y)
rightEyebrowArray[object]右眉毛关键点 9 个 ,每个点的值为坐标(x,y)
yawnumber人脸水平转动角度,取值范围为 -99 到 99
pitchnumber人脸俯仰角,取值范围为 -99 到 99
rollnumber人脸歪头角度,取值范围为 -99 到 99

boundingBox 属性

属性名类型属性说明备注
xnumber包围盒左上角 x 坐标坐标原点(0, 0)位于左上角,向右为 x 轴正向
ynumber包围盒左上角 y 坐标坐标原点(0, 0)位于左上角,向下为 y 轴正向
widthnumber包围盒宽度right-left 得到
heightnumber包围盒高度top-bottom 得到
leftnumber矩形框距离屏幕左边距离-
rightnumber矩形框距离屏幕右边距离-
topnumber矩形框距离屏幕上边距离-
bottomnumber矩形框距离屏幕下边距离-

actions 属性

取值取值说明
blink眨眼
blink_left左眨眼
blink_right右眨眼
mouth_ah嘴巴大张
head_yaw摇头
head_yaw_indian印度式摇头
head_pitch点头
brow_jump眉毛挑动
mouth_pout嘟嘴

使用提示

检测信息返回的坐标值可能需要进行缩放处理

const { width, height } = canvas; //要绘制的canvas const scalar = width / video.videoWidth; //video为摄像头返回的视频流对象 //例如,使用人脸包围盒时,需要以下处理: var boundindBoxX = boundingBox.x * scalar;

Bug & Tip

  • Tip:坐标轴的原点(0,0)位于设备的左上角,向右为 x 轴正向,向下为 y 轴正向。
  • Tip:DetectData 中的 actions 属性只有在 onActions 方法的回调中才有。
该文档是否有帮助?