Java 離線人臉識別SDK 支援arcface 2.0 最新版

gsmd_cc發表於2019-01-19

虹軟人臉識別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類,執行單元測試即可

參考資料

虹軟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位安裝即可。
許可證

本專案遵循 MIT 開源協議,手動比心?

相關文章