Skip to content

Latest commit

 

History

History
84 lines (59 loc) · 3.74 KB

优图人脸彩色活体文档.md

File metadata and controls

84 lines (59 loc) · 3.74 KB

优图人脸彩色活文档 FACE-LIVE-COLOR

输入抓拍的彩色图进行活体结果判断

version: v2.2.0

模型支持

v123 模型

  • 模型分数：人脸单目活体分数
  • 推荐阈值：[0.3, 0.5]（具体阈值请联系优图人员）

CHANGELIST

v2.2.0

  • [不兼容更新]：detect 输入为人脸框和红外图 RGB888 数据，输出为 true/false
  • [新增]：getScore，可以获得 detect 的最终分数结果，注意需要在 detect 之后立即获取
  • [新增]：getScores，可以获得 detect 的全部分数结果，注意需要在 detect 之后立即获取
  • [新增]：阈值默认放置 config.ini 文件中，通过静态方法 setThresholds 设置模型的阈值

v2.1.0

  • [feat]：修改底层接口，支持 windows 编译

v2.0.0

  • [不兼容更新]：优化和统一优图所有通用接口
  • [不兼容更新]：detect 方法去掉多余的参数，提高单次调用的性能

Java

package: com.tencent.youtu.YTFaceLiveColor

通用接口

  • static String getVersion();

    • @brief 获得 SDK + MODEL 的版本号，如v3.0.0-v7114
      • MODEL 的版本号由 config.ini 中读取获得
      • SDK 的版本号一般为 v3.0.0/v3.0.0-beta.0/v3.1.1-rc.0
    • @return 版本号

  • static int globalInit(String modelDirpath, String configFilename);

    • @brief 全局初始化函数，初始化模型，进程初始化一次即可，多线程不安全
    • @param modelDirpath 模型所在外部存储空间的绝对路径
    • @param configFilename 模型所在外部存储控件路径下 config 的文件名，如 config.ini
    • @return < 0 失败

  • static int globalInit(AssetManager assetManager, String modelDirpath, String configFilename);

    • @brief 全局初始化函数，初始化模型，进程初始化一次即可，多线程不安全
    • @param assetManager Android 管理 Assets 类，可通过 this.getAssets() 获得
    • @param modelDirpath 模型所在 Assets 存储下的相对路径
    • @param configFilename 模型所在 Assets 存储下的相对路径下 config 的文件名，如 config.ini
    • @return < 0 失败

  • static void globalRelease();

    • @brief 全局析构函数，进程结束析构一次即可，多线程不安全

  • static int setThresholds(float[] thresholds);

    • @brief 动态更改活体模型的比对阈值，一般可以采用默认阈值，默认阈值在 models/config.ini 下配置
    • @param thresholds 默认阈值，如有需要，请咨询优图人员，前面的阈值必须要小于后面的阈值
    • @return 返回是否设置成功，!= 0 失败， == 0 成功

  • void destroy();

    • @brief 每一个 new 出的实例，都需要明确的 destroy()。防止内存泄漏。

功能接口

  • float detect(float[] xy5Points, byte[] rgb888Data, int width, int height);

    • @brief 人脸彩色图活体判断打分
    • @param xy5Points 人脸关键五点[左眼，右眼，鼻尖，左嘴角，右嘴角]
    • @param rgb888Data RGB888图的图像数据，8 bits 三通道的RGB图
    • @param width RGB888图的宽
    • @param height RGB888图的高
    • @return 人脸彩色活体判断是否为真人，true 为真人，false 为攻击

  • float getScore();

    • @brief 获得 detect 过程中得到的最终分数。请在 detect 后立即串行调用。
    • @return 分数。当第一层分数小于第一层阈值的时候，返回第一层分数，否则返回第二层分数。要求第一层阈值必须小于第二层阈值。

  • float[] getScores();

    • @brief 获得 detect 过程中得到的所有模型的分数。请在 detect 后立即串行调用。
    • @return 分数数组