虹軟人臉識別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位