# wx.faceDetect(Object object)

该接口已停止维护，推荐使用 [wx.createVKSession](/miniprogram/dev/api/ai/visionkit/wx.createVKSession) 代替

> 基础库 2.18.0 开始支持，低版本需做[兼容处理](1003706)。

> __以 [Promise 风格](/miniprogram/dev/framework/app-service/api.md#异步-API-返回-Promise) 调用__：不支持
> 
> __小程序插件__：支持，需要小程序基础库版本不低于 [2.21.3](1003706)

## 功能描述

人脸检测，使用前需要通过 wx.initFaceDetect 进行一次初始化，推荐使用相机接口返回的帧数据。本接口不再维护，请使用 [wx.createVKSession](/miniprogram/dev/api/ai/visionkit/wx.createVKSession) 接口代替。详情参考[人脸检测指南文档](/miniprogram/dev/framework/open-ability/visionkit/face.md)

## 参数

### 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


```json
[
  {
    "属性": "detectRect",
    "类型": "Object",
    "说明": "脸部方框数值，对象包含 height, width, originX, originY 四个属性 (origin 为方框左上角坐标)"
  },
  {
    "属性": "x",
    "类型": "number",
    "说明": "脸部中心点横坐标，检测不到人脸则为 -1"
  },
  {
    "属性": "y",
    "类型": "number",
    "说明": "脸部中心点纵坐标，检测不到人脸则为 -1"
  },
  {
    "属性": "pointArray",
    "类型": "Array.<Object>",
    "说明": "标记人脸轮廓的 106 个点位置数组，数组每个对象包含 x 和 y"
  },
  {
    "属性": "confArray",
    "类型": "Object",
    "说明": "人脸置信度，取值范围 [0, 1]，数值越大置信度越高（遮挡越少）",
    "子项": [
      {
        "结构属性": "global",
        "类型": "number",
        "说明": "整体可信度"
      },
      {
        "结构属性": "leftEye",
        "类型": "number",
        "说明": "左眼可信度"
      },
      {
        "结构属性": "rightEye",
        "类型": "number",
        "说明": "右眼可信度"
      },
      {
        "结构属性": "mouth",
        "类型": "number",
        "说明": "嘴巴可信度"
      },
      {
        "结构属性": "nose",
        "类型": "number",
        "说明": "鼻子可信度"
      }
    ]
  },
  {
    "属性": "angleArray",
    "类型": "Object",
    "说明": "人脸角度信息，取值范围 [-1, 1]，数值越接近 0 表示越正对摄像头",
    "子项": [
      {
        "结构属性": "pitch",
        "类型": "number",
        "说明": "仰俯角（点头）"
      },
      {
        "结构属性": "yaw",
        "类型": "number",
        "说明": "偏航角（摇头）"
      },
      {
        "结构属性": "roll",
        "类型": "number",
        "说明": "翻滚角（左右倾）"
      }
    ]
  },
  {
    "属性": "faceInfo",
    "类型": "Array.<Object>",
    "说明": "多人模式（enableMultiFace）下的人脸信息，每个对象包含上述其它属性"
  }
]
```

### 特别说明
若小程序人脸识别功能涉及采集、存储用户生物特征（如人脸照片或视频、身份证和手持身份证、身份证照和免冠照等），此类型服务需使用[微信原生人脸识别接口](https://developers.weixin.qq.com/community/develop/doc/000442d352c1202bd498ecb105c00d?highline=%E4%BA%BA%E8%84%B8%E6%A0%B8%E8%BA%AB)。