SDK二次開發包
1、目的
封裝RECON人臉識別終端通信協定,提供介面給協力廠商做集成開發。支援發佈的所有人臉識別終端。介面名稱,傳入傳出參數力求做到自注釋。
SDK提供的介面,相當於完成了在程式中控制,只有通過人為操作終端才能實現與終端的交互功能。
同時,SDK也提供了一些終端沒有的功能介面,比如通過程式自動刪除考勤記錄,這些,無法通過在終端介面裡面手動操作(可通過WEB管理頁)。
2、適用範圍
發佈的動態連接庫基於ActiveX技術,在Windows平臺下有很強的適應性。可供VB,VC,Delphi,C#, PowerBuilder等等可使用ActiveX的語言使用。
對於大部分介面,都是使用“介面調用—>事件返回”的方式,是有好處的,這樣的非同步方式,可以讓使用SDK的協力廠商程式介面不會假死。
SDK封裝通訊協定是以這種方式來實現,通訊協定需要的參數,SDK以介面的參數方式進行填入,終端返回的結果欄位我們以回應事件在事件參數中回檔給協力廠商程式。
3、SDK使用約定
● SDK介面本身提供返回值,返回值的意思是SDK收到了協力廠商的請求,至於終端資料可在對應的事件中取得。SDK介面本身的返回值很重要;
● 當請求的命令中事件返回帶有特徵資料,照片資料等等參數時,不能單單靠判斷特徵/照片欄位的字串是否為空來判斷,而應該根據特徵/照片的指示原始長度判斷;
● 終端最小時間為1970-01-01 08:00:00, 最大時間為2038-01-19 11:14:07;除特別說明可用0000-00-00 00:00:00表示特別定義的時間外,時間欄位的參數應該為最小時間與最大時間之間正確的值;
● 在事件返回的類型為字串的參數/欄位,不能單純靠取此字串的長度為非0值而判斷有效,應該依靠OP_CODE,或者返回的此字串的長度,因為SDK給未知的參數/欄位賦值”Unknown???”;
● 使用者ID(0~10)為系統預留,有關操作用到用戶ID的必須大於等於11;
● 對同一個終端的操作,不能連續地調用兩個都有事件返回的介面,必須在一個介面的事件返回後,再調用另一個介面,不同的終端不受此限制
4、SDK測試DEMO
通過SDK所提供的測試DEMO,可以對封裝的介面函數進行調用測試,通過DEMO接收到的終端返回事件,可以方便的查看終端對於介面函數的執行及回應的情況,通過DEMO程式可以很好的引導二次開發。