biokeysdk程序開發手冊-資料下載頁

　　

【正文】 可能值：0: 好的指紋特征1: 特征點不夠2: 其它原因導致不能取到指紋特征Biokey SDK 開發手冊25 OnImageReceived(byval AImageValid As Boolean)設備取到指紋圖像或者通過 AddImageFile 和 AddBitmap 加入指紋圖像時調用該事件，AImageValid 表示是否進行模板提取，設置為 False 后，系統在取到指紋圖像后返回，不進行模板提取。 OnFingerTouching當手指按壓指紋取像設備時調用該事件。 OnFingerLeaving當手指移開指紋取像設備時調用該事件。Biokey SDK 開發手冊26工作流程說明OnImageReceivedOnFeatureInfoOnEnrollOnEnrollToFileTemplateImageIsRegister = True14 次否是BeginEnrollBiokey SDK 開發手冊27OnImageReceivedOnFeatureInfoOnCaptureOnCaptureToFileTemplateImageIsRegister = FalseBeginCaptureBiokey SDK 開發手冊28Biokey SDK 開發手冊29工作流程說明：指紋儀初始化進入工作狀態后，調用 BeginEnroll 處于登記指紋狀態，調用 BeginCapture 處于指紋驗證狀態。控件的工作方式是基于事件驅動，觸發事件的順序參考上面示意圖。指紋登記一般需要按同一手指 14 次，然后由識別系統綜合處理得到一個指紋登記模板，按壓登記指紋次數由控件屬性 EnrollCount 設置，達到設定次數后會觸發 OnEnroll 和 OnEnrollToFile 事件。指紋驗證時，按壓手指后會觸發 OnCapture 和 OnCaptureToFile 事件，此時可以調用 VerFinger 或者 IdentificationInFPCacheDB 進行 1:1 或者 1:N 比對。需要注意每次按壓手指都會觸發 OnFeatureInfo 事件，如果按壓手指的指紋模板質量不合格，則本次取像無效，需要重新按壓手指Biokey SDK 開發手冊30常見問題說明 1：1 和 1：N 的應用1：1 函數主要用于需要進行 1:1 驗證的開發項目，一般需要預先輸入當前驗證客戶的標識，然后得到他已經登記的一個或幾個模板與現場采集的模版進行驗證；而 1：N 函數主要用于不輸入客戶標識，直接通過客戶指紋從已經登記的指紋模板中找出自己。1：1 主要目標是高的通過率和相對高的準確率；1：N 主要目標是高的比對速度和相對高的準確率.。 數據庫中指紋模板寫入和讀出SDK 中指紋模板是以 Vairant 變量的方式保存和傳遞，其存儲的是一維二進制字節數組，不能像字符串一樣直接用 SQL 語句寫入和讀出，有下面處理方法： EncodeTemplate 和 DecodeTemplate 方法可以在 Variant 變量和字符串變量之間互相進行 BASE64 編碼轉換，轉換為字符串后，模板長度會增加大約 1/3。 在 OnEnroll 事件和 OnCapture 事件中直接調用 GetTemplateAsString 方法得到相應字符串形式的登記模板和比對模板。直接操作 Variant 變量，下面是操作示例：Delphi, CB：procedure (AQuery: TADOQuery。 AFingerID: Integer。 AFPData: Biokey SDK 開發手冊31OleVariant)。var pData: PChar。begin with AQuery do begin Close。 。 (39。SELECT * FROM zkFingerPrint WHERE FingerID = 39。 + IntToStr(AFingerID))。 Open。 if IsEmpty then Append else Edit。 FieldByName(39。FingerID39。).Value := AFingerID。 //保存指紋模板 with TBlobStream(CreateBlobStream(FieldByName(39。Template39。), bmWrite)) do begin pData := VarArrayLock(AFPData)。 try Write(pData^, VarArrayHighBound(AFPData, 1) VarArrayLowBound(AFPData, 1) + 1)。 finally VarArrayUnlock(AFPData)。 end。 Free。 end。 Post。 Close。 end。end。procedure (AQuery: TADOQuery。 AFingerID: Integer。 var AFPData: Biokey SDK 開發手冊32OleVariant)。var pData: PChar。begin with AQuery do begin Close。 。 (39。SELECT * FROM zkFingerPrint WHERE FingerID = 39。 + IntToStr(AFingerID))。 Open。 //讀取數據 if not IsEmpty then with TBlobStream(CreateBlobStream(FieldByName(39。Template39。), bmRead)) do begin AFPData := VarArrayCreate([0, Size + 1], varByte)。 pData := VarArrayLock(AFPData)。 try Read(pData^, Size)。 finally VarArrayUnlock(AFPData)。 end。 Free。 end。 Close。 end。end。Biokey SDK 開發手冊33 軟件加密狗和授權許可文件 已取消 1：N 高速緩沖空間的使用在 1：N 比對時，需要對比對模板進行分類，同時為了得到最高速度，SDK 需要創建內存空間，然后將已登記指紋加入到內存空間，高速緩沖空間實際上是內存空間，使用時需要首先用方法 CreateFPCahceDB 創建，然后用方法AddRegTemplateToFPCahceDB，RemoveRegTemplateFromFPCacheDB 等加入或者刪除指紋登記模板，最后可以使用方法 FreeFPCacheDB 釋放內存空間。可以同時創建多個高速緩沖空間以用于實現分組查詢等功能。 使用平面指紋圖像在一些工程項目中，很多時候要求保存指紋圖像，或者從掃描儀直接掃描得到平面指紋圖像，因此 BiokeySDK Starndard Version 或 BiokeySDK Project Versioin 提供方法 AddImageFile 等可以直接從平面指紋圖像得到指紋登記模板或比對模版的方法，但需要注意必須將圖像的分辨率則正確傳入此方法，要求不能低于 350DPI。注意，在普通版中 BiokeySDK Lite Version 不提供此方法。Biokey SDK 開發手冊34 指紋識別閥值的設定屬性 Threshold 推薦值為 10，此時誤判率大約 %，拒絕率大約 2%之間。屬性 OneToOneThreshold 的推薦值為 8。Score 的推薦值為 8 1：N 識別中低質量指紋模板的處理方法在 1：N 驗證時，在指紋登記時系統自動將指紋模板按照質量的好壞分類標識和保存在模板中，質量差的登記模板稱為 Biokey 1：1 低速比對特征模版,質量好的登記模板稱為 Biokey 高速比對特征模版。在一般的應用環境中，大約有 5%的登記指紋模板會被標識為低速比對特征模板，可以用方法 IsOneToOneTemplate 判斷是否是低速比對特征模版，用方法 ModifyTemplate 可以人為強行改變質量的好壞分類標識。由于 Biokey 1：1 低速比對速度比較慢（在 PII 233 大約 30ms）,所以使用方法 AddRegTemplateToFPCache 加入到高速緩沖空間中的低速比對特征模版不能太多，否則影響比對速度。在 1：N 驗證時，使用 IdentificationInFPCacheDB 進行指紋識別的流程如下圖：IdentificationFromFileInFPCacheDB (fpcHandle As Long, pVerTemplateFile As String, Byval Score As Long, Byval ProcessedFPNumber As Long) As LongBiokey SDK 開發手冊35是否否是是是比對模板 模板分類根據分類查找高速緩沖中指紋比對指紋比對分數=Threshold比對分數=3保存到可疑指紋列表全部比對可疑指紋最高分=ScoreBiokey SDK 開發手冊36是否FALSE是否FALSE否TRUETRUE對可疑指紋 1:1 低速比對比對結果全部比對對高速緩沖中低速指紋 1:1 比對比對結果全部比對識別失敗Biokey SDK 開發手冊37 連接多個指紋儀窗口中一個控件對應一個指紋儀，使用 SensorIndex 設置不同指紋儀，指紋儀個數通過屬性 SensorCount 得到，如果需要區分各個指紋儀，使用屬性 SensorSN，每個指紋儀的 SensorSN 是唯一的。 模板操作的文件/ 字符串/變體變量方法為了在不同開發語言中，方便操作模板的登記，比對等，可以選擇文件方式、字符串和變體變量等三種方式進行。以下分別列出，請參考：模板 Variant 和 String 之間的轉換EncodeTemplate, EncodeTemplate1 : Variant StringDecodeTemplate, DecodeTemplate1 : String Variant添加模板到高速緩沖區 AddRegTemplateToFPCacheDB Variant AddRegTemplateStrToFPCacheDB String AddRegTemplateFileToFPCacheDB File 在高速緩沖識別指紋返回結果 識別成功Biokey SDK 開發手冊38 IdentificationFromInFPCacheDB Variant IdentificationFromStrInFPCacheDB StringIdentificationFromFileCacheDB File1:1 比對模板VerFinger VariantVerFingerFromStr StringVerFingerFromFile FileDEMO 程序說明以下使用 1:N 控件的 VB 例子程序進行說明（1:1 控件使用基本相似） 。首先確認已經注冊 1:N 控件，加密狗插入到并行口或者授權文件已經拷貝到當前應用程序路徑下，已經安裝指紋儀驅動程序。運行 VB 的 Demo 顯示如下界面：Biokey SDK 開發手冊39窗口指紋控件名稱為 ZKFPEngX1。首先，點擊《初始化》按鈕初始化指紋儀，如果成功會顯示成功的提示信息。初始化代碼如下： If = 0 Then MessageBox 0, 初始化成功！ , 提示信息, 0 = 指紋儀連接 = amp。 = amp。 = = FalseBiokey SDK 開發手冊40 FMatchType = 0 End If點擊《登記指紋》按鈕進入指紋登記狀態，代碼如下： If Trim() = Then MessageBox 0, 請輸入指紋名稱標識 !, 錯誤, 0 Exit Sub End If = 開始登記此時指紋儀會處于登記狀態，每次按壓指紋會觸發 OnImageReceived(顯示圖像) ，OnFeatureInfo（判斷指紋質量是否合格）事件。按壓 14 有效次數手指（指紋質量不合格的不算次數） ，會觸發 OnEnroll，OnEnrollToFile 事件，具體按壓次數由屬性 EnrollCount 設置。OnEnrol