# VKSession.detectFace(Object object)

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

> __小程序插件__：支持，需要小程序基础库版本不低于 [2.25.0](1003706)

## 功能描述

静态图像人脸关键点检测。当 wx.createVKSession 参数传入 {track: {face: {mode: 2} } } 时可用。用法详情[指南文档](/miniprogram/dev/framework/open-ability/visionkit/face.md)。安卓微信8.0.25开始支持，iOS微信8.0.24开始支持。

## 参数

### Object object


```json
[
  {
    "属性": "frameBuffer",
    "类型": "ArrayBuffer",
    "默认值": "",
    "必填": "是",
    "说明": "人脸图像像素点数据，每四项表示一个像素点的 RGBA"
  },
  {
    "属性": "width",
    "类型": "number",
    "默认值": "",
    "必填": "是",
    "说明": "图像宽度"
  },
  {
    "属性": "height",
    "类型": "number",
    "默认值": "",
    "必填": "是",
    "说明": "图像高度"
  },
  {
    "属性": "scoreThreshold",
    "类型": "number",
    "默认值": "0.8",
    "必填": "否",
    "说明": "评分阈值。正常情况传入 0.8 即可。"
  },
  {
    "属性": "sourceType",
    "类型": "number",
    "默认值": "1",
    "必填": "否",
    "说明": "图像源类型。正常情况传入 1 即可。当输入的图片是来自一个连续视频的每一帧图像时，sourceType 传入 0 会得到更优的效果",
    "子项": [
      {
        "合法值": "1",
        "说明": "表示输入的图片是随机的图片"
      },
      {
        "合法值": "0",
        "说明": "表示输入的图片是来自一个连续视频的每一帧图像"
      }
    ]
  },
  {
    "属性": "modelModel",
    "类型": "number",
    "默认值": "1",
    "必填": "否",
    "说明": "算法模型类型。正常情况传入 1 即可。0、1、2 分别表示小、中、大模型，模型越大识别准确率越高，但资源占用也越高。建议根据用户设备性能进行选择。",
    "子项": [
      {
        "合法值": "0",
        "说明": "小模型"
      },
      {
        "合法值": "1",
        "说明": "中模型"
      },
      {
        "合法值": "2",
        "说明": "大模型"
      }
    ]
  },
  {
    "属性": "pupilInfo",
    "类型": "boolean",
    "默认值": "false",
    "必填": "否",
    "说明": "是否返回瞳孔周围点信息，默认为 false。"
  }
]
```

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