Skip to content

Latest commit

 

History

History
91 lines (62 loc) · 3.65 KB

优图人脸特征文档.md

File metadata and controls

91 lines (62 loc) · 3.65 KB

优图人脸特征文档 FACE-FEATURE

对输入的人脸图片进行特征提取

version: v3.0.2

模型

请根据使用的场景加载合适的模型目录，并设置相应的阈值

v704 模型

  • 适用场景：门禁场景（性能更好，效果相对 v711x 系列要略差）
  • 推荐阈值：80.0（用于检索的阈值）

v7116 模型

  • 适用场景：门禁场景（效果更好，性能比 v70x 系列要慢 250ms 左右）
  • 推荐阈值：80.0（用于检索的阈值）

v7115 模型

  • 适用场景：支付场景
  • 推荐阈值：请联系优图相关人员具体评估

CHANGELIST

v3.0.2

  • [更新模型] 更新门禁场景模型，v703 模型至 v704 模型，有效覆盖口罩场景
  • [新增模型] 新增（效果更好）门禁场景模型，v7116 模型，能够有效覆盖口罩场景

v3.0.1

  • [新增模型] 更新门禁场景模型，v703 模型
  • [新增模型] 更新支付场景模型，v7115 模型

v3.0.0

  • [不兼容升级] import 的 jar 包的路径变更为 com.tencent.youtu.YTFaceFeature
  • [移除接口] compareFaceDistance 特征比对移至 face-retrieve 中
  • [新增接口] 新增接口 globalRelease 用以替换 NativeGlobalReleaseSDK
  • [新增接口] 新增重载接口 globalInit 支持直接读取 assets 目录下的模型文件
  • [新增接口] 新增接口 globalInit 用以替换 NativeGlobalInitSDK
  • [新增接口] 新增接口 getVersion 用以输出 SDK 和模型的版本

Java 接口

package: com.tencent.youtu.YTFaceFeature

常量

  • static final int FEATURE_LENGTH: 当前人脸特征版本提取的人脸特征长度

通用接口

  • 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 dirPath, String configFilename);

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

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

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

  • static void globalRelease();

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

  • void destroy();

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

功能接口

  • int extract(float[] xy5Points, byte[] rgbData, int width, int height, float[] feature);
    • @brief 根据输入的人脸关键五点和图片数据，提取人脸特征，多线程安全
    • @param xy5Points 输入当前 RGB 图片对应人脸的五点坐标，[左眼，右眼，鼻尖，左嘴角，右嘴角]
    • @param rgbData 输入 RGB 图像数据
    • @param width 输入 RGB 图像 宽
    • @param height 输入 RGB 图像 高
    • @param feature 输出特征值序列结果，此特征值已经完成归一化
    • @return == 0 => 成功，!= 0 => 失败