虹軟人臉識別SDK之Java版,支持SDK 1.1+,以及當前最新版本2.0,滴滴,抓緊上車!
JDK SDK Win release license status
前言
由於業務需求,最近跟人臉識別槓上了,本以爲虹軟提供的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-wan...
然後將項目導入到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類,運行單元測試即可
參考資料
(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位安裝即可。
許可證
本項目遵循 MIT 開源協議,手動比心😊