人脸识别

mtl支持版本6.0.11及以上

插件名称：百度人脸识别(带界面)

封装了百度人脸识别SDK，此版SDK包含人脸检测、活体识别等功能

添加插件所需参数

字段 类型 必填 说明
file_license文件 文件 是 用于SDK离线功能使用，在您的申请人脸SDK的后台页面，全局->产品服务->人脸识别->离线采集SDK管理
iOS人脸license后缀 string 是 上传文件后缀(face-ios)
iOS人脸license文件名 string 是 上传文件名称(idl-license)
应用名称(appname)+「-face-ios」后缀 string 是 iOS license ID名称
android人脸licenseID string 是 安卓 license ID名称
android配置license文件步骤中配置的文件名称 string 是 上传文件名称(idl-license.face-android)

封装百度License插件

ios配置license文件：

下载 UIBdFaceAppendix 插件 zip 包并解压，把 zip 包内 target 目录下的 license文件替换为自己申请的license文件。然后重新压缩为 zip 包文件上传自定义插件，打包时勾选该插件。

android配置license文件：

下载 bdFaceAppendix插件zip包并解压(解压后会看到一个UIBdFaceAppendix文件夹) (2) 将文件夹中的source目录下的license.jar解压(会看到一个\assets\目录) (3) 从百度后台下载license文件替换掉第(2)步解压出来的\assets\目录中文件，并重新将assets打成jar包(命名成license.jar)，替换掉之前的jar包。 (4)UIBdFaceAppendix文件夹重新打包为zip文件，以自定义插件方式加入项目

人脸功能配置

configuration

支持平台

微信 友空间 安卓 iOS
✘ ✘ ✔︎ ✔︎

参数

字段 类型 默认值 必填 说明
minFaceSize number 200 否 最小检测人脸阈值
cropFaceSizeWidth number 400 否 截取人脸图片大小
occluThreshold number 0.5 否 人脸遮挡阀值
blurThreshold number 0.7 否 图像模糊阀值
eulurAngle string
否 头部姿态角度
timeout number 10 否 超时时间
threshold number 0.6 否 人脸检测精度阀值
maxCropImageNum number 1 否 照片采集张数
sound boolean true 否 是否开启提示音

eulurAngle参数

字段 类型 默认值 必填 说明
pitch number 10 否 三维旋转之俯仰角度[-90(上), 90(下)]
yaw number 10 否 三维旋转之左右旋转角[-90(左), 90(右)]
roll number 10 否 平面内旋转角[-180(逆时针), 180(顺时针)]

示例

mtl.ai.configuration({
  success: function(res) {

    },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

打开活体检测页面

openLivenessView

支持平台

微信 友空间 安卓 iOS
✘ ✘ ✔︎ ✔︎

参数

字段 类型 默认值 必填 说明
actions array
否 活体检测动作
0/眨眼，1/张嘴，2/向右摇头，3/向左摇头，
4，抬头，5，低头，
6/摇头（1.0.2以及以后版本不再支持），
7/没有动作
isByOrder boolean true 否 是否按顺序进行活体动作
numOfLiveness number 3 否 活体动作数目（actions为空时起作用）

示例

mtl.ai.openLivenessView({
  success: function(res) {
     status:0,           //数字类型；检测结果
     bestImagePaths:[],  //数组类型；status为0返回（1.0.2以及之后版本插件 android不支持）
     liveEyePath:'',     //字符类型；status为0返回（1.0.2以及之后版本插件 android不支持）
     liveMouthPath:'',   //字符类型；status为0返回（1.0.2以及之后版本插件 android不支持）
     yawRightPath:'',    //字符类型；status为0返回（1.0.2以及之后版本插件 android不支持）
     yawLeftPath:'',     //字符类型；status为0返回  （1.0.2以及之后版本插件 android不支持）
     pitchUpPath:'',     //字符类型；status为0返回 （1.0.2以及之后版本插件 android不支持）
     pitchDownPath:'',    //字符类型；status为0返回 （1.0.2以及之后版本插件 android不支持）
      bestImageStr:'',    //字符串类型，status为0返回  质量最优的图片base64字符串 （1.0.2以及之后版本插件 android返回）
      imageStrs:[     //数组类型；status为0返回 所有图片base64字符串（1.0.2以及之后版本插件 android返回）
          {key:'',      //字符串类型
          value:'',},    //字符串类型；图片base64字符串
      ],
    },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});

检测结果参考

0：成功 1：头部偏低 2：头部偏高 3：头部偏左 4：头部偏右 5：光照不足 6：没有检测到人脸 9：图像模糊 10：左眼有遮挡 11：右眼有遮挡 12：鼻子有遮挡 13：嘴巴有遮挡 14：左脸颊有遮挡 15：右脸颊有遮挡 16：下颚有遮挡 17：太近 18：太远 19：出框 20：眨眨眼 21：张大嘴 22：向左摇头 23：向右摇头 24：向上抬头 25：向下低头 26：摇摇头 27：完成一个活体动作 28：verifyInitError 29：verifyDecryptError 30：verifyInfoFormatError 31：verifyExpired 32：verifyMissRequiredInfo 33：verifyInfoCheckError 34：verifyLocalFileError 35：verifyRemoteDataError 36：超时 37：conditionMeet

打开人脸图像采集页面

openDetectionView

支持平台

微信 友空间 安卓 iOS
✘ ✘ ✔︎ ✔︎

参数
-无-
示例

mtl.ai.openDetectionView({
  success: function(res) {
     status:0,           //数字类型；检测结果
     bestImagePaths:[],  //数组类型；status为0返回 (1.0.2以及以后版本 android不支持)
     bestImageStr:'',    //字符串类型，status为0返回  质量最优的图片base64字符串 （1.0.2以及之后版本插件 android返回）
     imageStrs:[     //数组类型；status为0返回 所有图片base64字符串（1.0.2以及之后版本插件 android返回）
          {key:'',      //字符串类型
          value:'',},    //字符串类型；图片base64字符串
      ],
    },
  fail: function(err) {
    var message = err.message; // 错误信息
  }
});
是否仍需要帮助？ 请保持联络！
最后更新于 2026/04/24