Java版 人脸识别SDK dem

时间:2021-03-07 21:56:25

虹软人脸识别SDK之Java版,支持SDK 1.1+,以及2.0版本,滴滴,抓紧上车!

前言
由于业务需求,最近跟人脸识别杠上了,本以为虹软提供的SDK是那种面向开发语言的,结果是一堆dll······像我这样的Java猿突然就感觉整个人都不好了;近期赶上了SDK2.0的升级,在官方论坛、Google、百度、QQ等等的帮助下,爬过了一个又一个坑,终于搞定了!噗!回过头来发现不少伙伴们都像我当初一样迷茫,So,我回来拯救世界了~

后更:刚写了没多久,虹软SDK的Java版Demo就出来了.................

注意

/ 本项目需要lombok的支持
/ 虹软官方分为“人证SDK”、“活体检测”和“ArcFace”三种,本项目使用的是“ArcFace”
/ Windows 32位、64位指的是JDK,并不是Windows操作系统的位数
/ master分支为最新的SDK 2.0版本,1.x的版本实现请查看1.x分支(1.x实现来自于官方论坛Demo)
/ 本项目实现了对SDK的轻度封装,且为单线程模式,多线程情况下尚未测试,放过可怜的孩子吧...

功能特点

对SDK接口进行了二次封装,所有操作只需要一个简单的工具类就ojbk,用起来爽的一批~

  

- 激活引擎
- 初始化引擎
- 检测人脸
- 提取特征值
- 对比特征值
- 年龄/性别/角度检测预处理
- 获取年龄
- 获取性别
- 获取3D角度
- 获取引擎版本
- 销毁引擎

快速开始
安装项目

git clone https://github.com/jastar-wang/arcface.git

  

然后将项目导入到Eclipse或IDEA中并进行maven update

下载DLL
登录虹软官方网站,下载ArcFace 2.0的SDK,并将libarcsoft_face.dll和libarcsoft_face_engine.dll两个文件粘贴到src/test/resources目录下

配置KEY
将官网获取到的SDK激活码填入到com.arcsoft.face.util.ConfUtil类的对应常量中

测试
打开com.arcsoft.face.EngineTest类,运行单元测试即可

参考资料

-虹软SDK的常见问题指南
-虹软官方问答指导集锦

  

常见问题
(1)SDK有效期?

答:SDK激活码有效期为一年,到期之后需要重新申请激活码,并且重新下载SDK,SDK与激活码应当匹配。

(2)SDK 2.0首次使用?

答:2.0版本首次使用需要联网激活,激活后会在程序运行目录下生成几个“.dat”文件(asf_install.dat,freesdk_数字.dat),之后则可以离线使用;若更换了机器设备,需要删除这些“.dat”文件,并重新联网激活。

(3)SDK 2.0特征值?

答:1.x的版本特征值大小为20k左右,2.0版本算法做了大幅优化,缩小到了1k,且长度固定为1023 byte。

(4)SDK 2.0对于图片的要求?

答:图片的宽度必须是4的整数倍;当图片为BGR模式时,高度需要是2的整数倍。

(5)SDK 2.0的阈值?

答:由于2.0的算法做了优化,匹配度相对较高,推荐阈值设置为0.8(1.x版本为0.6),具体根据实际场景上下调整。

(6)SDK 2.0提取特征值?

答:2.0版本对内存做了优化,会反复使用同一个特征值对象的内存,所以提取特征值之后需要对特征值对象重新copy,否则SDK再进行提取时会覆盖了原特征值。

(7)关于多线程使用?

答:多线程使用场景下,每个线程都需要初始化一个引擎。

(8)如何加载图片?

答:可以使用“ImageIO.read()方式读取图片,但该方式读取某些类型的图片时,不会正确读取ICC的信息,因此会在写出图片时生成一层红色蒙版(如果不写出图片那就无所谓)。有两种解决方案:(1)参照EngineTest.testAll()方法中的加载方式,这种方式仅限于Windows下使用,因为需要用到图形环境的支持。(2)使用javacv(基于opencv)加载图片,pom依赖中已注释,本人放弃的原因是因为jar包太大且需求不会有Linux环境。”

(9)运行EngineTest单元测试提示“...找不到指定模块”?

答:这是因为你的系统缺少dll运行的必要组件,别担心,点击 这里 进行下载,根据自身情况选择32位或64位安装即可。