Skip to content

Latest commit

 

History

History
95 lines (65 loc) · 3.72 KB

优图人脸质量文档.md

File metadata and controls

95 lines (65 loc) · 3.72 KB

优图人脸质量文档

评估输入图片的人脸质量分

version: v2.4.0

模型支持

v110 模型

  • 推荐场景：支付场景/门禁场景（具体场景请联系优图人员）
  • 模型分数：一个分数，为 [人脸质量总分]
  • 推荐阈值：0.4 或者 0.5 或者 0.63（具体阈值请联系优图人员）

v111 模型

  • 推荐场景：支付场景/门禁场景（具体场景请联系优图人员）
  • 模型分数：两个分数，为 [人脸质量总分, 是否戴口罩]
  • 推荐阈值（人脸质量总分）：0.4 或者 0.5 或者 0.63（具体阈值请联系优图人员）
  • 推荐阈值（是否戴口罩）：0.387207, 小于此阈值认为是戴口罩

v312 模型

  • 推荐场景：支付场景/门禁场景（具体场景请联系优图人员）
  • 模型分数：一个分数，为 [人脸质量总分]
  • 推荐阈值：0.4 或者 0.5 或者 0.63（具体阈值请联系优图人员）

CHANGELIST

v2.4.0

  • [不兼容更新] evaluate 接口返回分数数组，分数取决于模型，具体请查看模型支持
  • [增加模型] 增加新的 v111 模型，用于获取是否带口罩

v2.3.0

  • [feat] 支持 windows 版本
  • [feat] 支持同时加载 v11x 系列模型和 v31x 系列模型
  • [fix] 解决了部分bug

v2.2.0

  • [模型升级] 算法模型升级至 v110

v2.1.0

  • [模型升级] v311 算法模型升级至 v312
  • [不兼容更新] evaluate 只返回人脸质量分，不包含眼镜分

v2.0.0

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

Java

package: com.tencent.youtu.YTFaceQuality

通用接口

  • 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 全局析构函数，进程结束析构一次即可，多线程不安全

  • void destroy();

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

功能接口

  • float[] evaluate(float[] xy5Points, byte[] rgb888Data, int width, int height);
    • @brief 获得人脸图片质量
    • @param xy5Points 人脸关键五点 [左眼中心，右眼中心，鼻尖，左嘴角，右嘴角]
    • @param rgb888Data RGB图的图像数据，8 bits 三通道的RGB图
    • @param width RGB图的宽
    • @param height RGB图的高
    • @return 当评估失败的时候，返回 null，注意处理异常情况
    • @return 返回质量分数数组，每个分数为 0-1 区间，具体分数结果取决于加载的模型版本