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

虹軟人臉識別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 開源協議,手動比心😊

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章