抖音开放平台Logo
开发者文档
控制台
  • API 概览
  • 开放能力
  • 基础
  • 渲染
  • 设备
  • 文件
  • 位置
  • 媒体
  • 图片
  • 音频
  • 录屏
  • 麦克风
  • 相机
  • 录音
  • 视频
  • 人脸检测
  • tt.createFaceDetector
  • Detector
  • DetectData
  • 手势识别
  • 网络
  • 游戏转发分享
  • 实时语音
  • 数据缓存
  • 系统
  • 广告
  • 界面
  • 支付
  • Worker
  • 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 方法的回调中才有。
    该文档是否有帮助?