DONSEE東信智能 - 身份證社保卡讀卡智能終端應用服務商

廣東東信智能科技有限公司DONSEE EST-100多功能手寫簽批屏SDK開發包，包括了手寫簽字、指紋采集、讀身份證、社保卡、IC卡、銀行卡、高拍儀、人臉識別比對等多種功能。

開發文檔下載地址：

1、東信智能多功能簽批屏WindowsSDK開發包-20250818下載

2、開發文檔下載↓

產品銷售咨詢：138-2221-6429

開發技術咨詢：139-2221-0502

東信智能多功能簽批屏DLL接口說明

廣東東信智能科技有限公司

www.www.57bjl.cn

目錄

1. 設備操作 4

1.1. 打開設備 4

1.2. 關閉設備 4

1.3. 獲取設備序列號 5

1.4. 釋放讀取序列號的內部內存 5

1.5. 寫入序列號(僅支持特定版本） 5

1.6. 設置首頁背景 5

1.7. 重置背景 6

1.8. 更新APK 6

1.9. 打開日志 6

1.10. 刪除日志 6

1.11. 打開語音播報 7

1.12. 打開網頁 7

1.13. 關閉網頁 7

2. 簽字板 7

2.1. 設置簽字板標題 7

2.2. 設置筆顏色 8

2.3. 設置筆壓 8

2.4. 設置簽字框位置 8

2.5. 設置邊框 9

2.6. 設置邊框顏色 9

2.7. 設置簽字圖片寬度 9

2.8. 設置簽字圖片高度 9

2.9. 開始簽字 10

2.10. 重簽 10

2.11. 關閉簽字板 10

2.12. 獲取簽字筆跡圖片路徑 10

2.13. 釋放簽字圖片路徑內存 11

2.14. 獲取簽字筆跡圖片（回調方式） 11

2.15. 獲取簽字圖片base64 11

2.16. 釋放簽字圖片base64內存 12

2.17. 保存簽字圖片路徑（內部創建） 12

2.18. 保存簽字圖片路徑（外部傳入） 12

2.19. 打開簽字指紋合成 13

2.20. 關閉簽字指紋合成 13

3. 高拍采集 13

3.1. 打開相機 13

3.2. 打開相機（指定分辨率） 14

3.3. 拍照（保存圖片路徑） 14

3.4. 拍照（保存圖片base64） 14

3.5. 拍照（外部傳入路徑） 15

3.6. 釋放拍照圖片base64 內存 15

3.7. 關閉攝像頭 16

3.8. 獲取攝像頭個數 16

3.9. 返回攝像頭名稱 16

3.10. 釋放攝像頭名稱內存 16

3.11. 獲取分辨率列表（所有攝像頭） 17

3.12. 釋放攝像頭分辨率列表內存 17

3.13. 獲取當前分辨率 17

3.14. 旋轉 18

3.15. 沿x軸翻轉 18

3.16. 沿y軸翻轉 18

3.17. 開啟自動裁剪 18

3.18. 關閉啟動裁剪 19

3.19. 設置自定義裁剪 19

3.20. 關閉自定義裁剪 19

3.21. 縮小 19

3.22. 放大 20

3.23. 設置預覽回調 20

4. 身份證讀取 20

4.1. 讀取身份證 20

4.2. 讀取身份證（異步調用） 21

4.3. 讀取身份證（后臺） 21

4.4. 讀取身份證頭像 21

4.5. 釋放讀取身份證頭像內存 22

4.6. 讀取身份證指紋數據 22

4.7. 釋放身份證指紋數據內存 22

4.8. 停止讀取身份證 22

4.9. 釋放讀取身份證信息內存 23

5. 指紋讀取 23

5.1. 設置讀取指紋回調函數 23

5.2. 創建指紋模版 23

5.3. 指紋特征比對 24

5.4. 讀取指紋base64 24

5.5. 釋放讀取指紋圖片base64內存 25

5.6. 關閉指紋讀取 25

6. 條碼讀取 25

6.1. 讀取條碼信息 25

6.2. 釋放條碼信息內存 26

7. 服務評價 26

7.1. 開始評價 26

7.2. 關閉評價 26

8. 文件簽字 27

8.1. 發起PDF簽字（任意簽） 27

8.2. 關閉PDF簽字 27

8.3. 開始關鍵字簽字 28

8.4. 關閉關鍵字簽字 28

8.5. 開始圖片簽字 29

8.6. 關閉圖片簽字 29

9. 社保卡讀取 30

9.1. 打開社保卡讀卡器 30

9.2. 讀取基本信息 30

9.3. 讀基本信息（回調方式） 30

9.4. 基于加密機的加密步驟一 31

9.5. 基于加密機的加密步驟二 31

9.6. 釋放社保卡讀取的信息內存 31

9.7. 關閉社保卡讀取 32

10. 人證核驗 32

10.1. 發起人證核驗 32

10.2. 發起人證核驗2 33

10.3. 關閉人證核驗 34

11. 工具類 34

11.1. 圖片轉base64 34

11.2. 釋放圖片轉base64分配的內存 34

11.3. 圖片列表轉PDF 35

11.4. 釋放圖片列表轉PDF路徑的內存 35

1.設備操作

1.1.打開設備

函數原型: int DX_OpenDev() 

函數名 參數 返回值

DX_OpenDev 無 見 E_SDK_ERROR

1.2.關閉設備

函數原型: int DX_CloseDev() 

函數名 參數 返回值

DX_CloseDev 無 見 E_SDK_ERROR

1.3.獲取設備序列號

函數原型: int DX_GetSN(char **pOutSN) 

函數名 參數 返回值

DX_GetSN pOutSN: 返回設備序列號 見 E_SDK_ERROR

1.4.釋放讀取序列號的內部內存

函數原型: int DX_FreeGetSN(char **p) 

函數名 參數 返回值

DX_FreeGetSN p: 釋放獲取序列號內部分配的內存 見 E_SDK_ERROR

1.5.寫入序列號(僅支持特定版本）

函數原型: int DX_WriteSN(const char *SN, int nLen) 

函數名 參數 返回值

DX_WriteSN SN: 待寫入的序列號

nLen: 序列號的長度 見 E_SDK_ERROR

1.6.設置首頁背景

函數原型: int DX_SetBgLogo(const char *logoPath)

函數名 參數 返回值

DX_SetBgLogo logoPath: 背景圖片的內存，建議小于500KB 見 E_SDK_ERROR

1.7.重置背景

函數原型: int DX_ResetBg()

函數名 參數 返回值

DX_ResetBg 無 見 E_SDK_ERROR

1.8.更新APK

函數原型: int DX_UpdateAPK(const char *apkPath) 

函數名 參數 返回值

DX_UpdateAPK apkPath：apk路徑 見 E_SDK_ERROR

1.9.打開日志

函數原型: int DX_OpenLogs(int flags) 

函數名 參數 返回值

DX_OpenLogs flags: 0： 關閉輸出

1: 打開日志輸出 見 E_SDK_ERROR

1.10.刪除日志

函數原型: int DX_DeleteLogs() 

函數名 參數 返回值

DX_DeleteLogs 無 見 E_SDK_ERROR

1.11. 打開語音播報

函數原型: int DX_OpenDeviceTTS(int flags) 

函數名 參數 返回值

DX_OpenDeviceTTS flags: 

0:關閉語音播報

1: 開啟語音播報 見 E_SDK_ERROR

1.12. 打開網頁

函數原型: int DX_OpenWebUrl(const char *url) 

函數名 參數 返回值

DX_OpenWebUrl url網頁地址 見 E_SDK_ERROR

1.13. 關閉網頁

函數原型: int DX_CloseWebUrl() 

函數名 參數 返回值

DX_CloseWebUrl 無 見 E_SDK_ERROR

2.簽字板

2.1.設置簽字板標題

函數原型: int DX_SetTitle(const char *title, int nLen)

函數名 參數 返回值

DX_SetTitle title: 簽字板標題

nLen: 標題長度 見 E_SDK_ERROR

2.2.設置筆顏色

函數原型: int DX_SetPenColor(int color)

函數名 參數 返回值

DX_SetPenColor color: 筆顏色（ARGB格式）,例如紅色: 0xFFFF0000 見 E_SDK_ERROR

2.3.設置筆壓

函數原型: int DX_SetPenPressure(float pressure)

函數名 參數 返回值

DX_SetPenPressure Pressure: 筆壓等級，0.1-1.0 見 E_SDK_ERROR

2.4.設置簽字框位置

函數原型: int DX_SetPos(int x, int y, int width, int height) 

函數名 參數 返回值

DX_SetPos x: 距離屏幕左邊像素

y: 距離屏幕頂部像素

width: 簽字框寬度

height: 簽字框高度 見 E_SDK_ERROR

2.5.設置邊框

函數原型: int DX_SetBorder(int type) 

函數名 參數 返回值

DX_SetBorder type: 設置邊框樣式， 0： 無邊框1： 默認邊框 見 E_SDK_ERROR

2.6.設置邊框顏色

函數原型: int DX_SetBorderColor(int color)

函數名 參數 返回值

DX_SetBorderColor color: 邊框顏色    見 E_SDK_ERROR

2.7.設置簽字圖片寬度

函數原型： int DX_SetSignImageWidth(int width)

函數名 參數 返回值

DX_SetSignImageWidth width:寬度      見 E_SDK_ERROR

2.8.設置簽字圖片高度

函數原型: int DX_SetSignImageHeight(int height)

函數名 參數 返回值

DX_SetSignImageHeight height: 高度 見 E_SDK_ERROR

2.9.開始簽字

函數原型: int DX_StartSign();

函數名 參數 返回值

DX_StartSign 無 見 E_SDK_ERROR

2.10.重簽

函數原型: int DX_ReSign() 

函數名 參數 返回值

DX_ReSign 無 見 E_SDK_ERROR

2.11.關閉簽字板

函數原型: int DX_CloseSignBoard() 

函數名 參數 返回值

DX_CloseSignBoard 無 見 E_SDK_ERROR

2.12.獲取簽字筆跡圖片路徑

函數原型: int DX_GetSignData(int type, char **pOutImgPath) 

函數名 參數 返回值

DX_GetSignData type: 0: bmp(暫不支持)、1: jpg、2: png

pOutImgPath: 簽字圖片路徑 見 E_SDK_ERROR

2.13.釋放簽字圖片路徑內存

函數原型: int DX_FreeGetSignData() 

函數名 參數 返回值

DX_FreeGetSignData 無 見 E_SDK_ERROR

2.14.獲取簽字筆跡圖片（回調方式）

函數原型: int DX_SetSignImgCallback(int type, DX_OnSignImgCallback callback) 

函數名 參數 返回值

DX_GetSignData type: 0: bmp(暫不支持)、1: jpg、2: png

callback: 簽字圖片回調函數，原型見下面 見 E_SDK_ERROR

typedef void(DXSDK_CALL *DX_OnSignImgCallback)(char *pSignImgBase64);

2.15.獲取簽字圖片base64

函數原型: int DX_GetSignBase64(int type, char **pOutBase64) 

函數名 參數 返回值

DX_GetSignBase64 type: 0: bmp(暫不支持)、1: jpg、2: png

pOutBase64: 簽字圖片base64 見 E_SDK_ERROR

2.16.釋放簽字圖片base64內存

函數原型: int DX_FreeGetSignBase64() 

函數名 參數 返回值

DX_FreeGetSignBase64 無 見 E_SDK_ERROR

2.17.保存簽字圖片路徑（內部創建）

函數原型: int DX_SaveSignImage(int type, char **pOutImgPath) 

函數名 參數 返回值

DX_SaveSignImage type: 0: bmp(暫不支持)、1: jpg、2: png

pOutImgPath: 簽字圖片路徑 見 E_SDK_ERROR

2.18.保存簽字圖片路徑（外部傳入）

函數原型: int DX_SaveSignImage2(int type, const char *pInImgPath) 

函數名 參數 返回值

DX_SaveSignImage2 type: 0: bmp(暫不支持)、1: jpg、2: png

pInImgPath: 簽字圖片路徑，需帶上文件后綴，例如xxx.jpg、xxx.png 見 E_SDK_ERROR

2.19.打開簽字指紋合成

函數原型: int DX_StartSignAndFinPng(DX_OnSignAndFinCallback callback) 

函數名 參數 返回值

DX_StartSignAndFinPng callback: 函數原型如下 見 E_SDK_ERROR

typedef void(DXSDK_CALL *DX_OnSignAndFinCallback)(int errorCode, char *pSignImgBase64, char *pFinImgBase64, char *pSignAndFinImgBase64);

2.20.關閉簽字指紋合成

函數原型: int DX_CloseSignAndFinPng() 

函數名 參數 返回值

DX_CloseSignAndFinPng 無 見 E_SDK_ERROR

3.高拍采集

3.1.打開相機

函數原型: int DX_OpenCamera(int index) 

函數名 參數 返回值

DX_OpenCamera index: 攝像頭索引 見 E_SDK_ERROR

3.2.打開相機（指定分辨率）

函數原型: int DX_OpenCamera2(int index,int width, int height) 

函數名 參數 返回值

DX_OpenCamera2 index: 攝像頭索引

width: 分辨率寬

height: 分辨率高 見 E_SDK_ERROR

3.3.拍照（保存圖片路徑）

函數原型: int DX_TakePicturePath(int index, int quality, char **pOutImgPath) 

函數名 參數 返回值

DX_TakePicturePath index: 攝像頭索引

qualit: 圖片壓縮質量0~100

pOutImgPath: 返回的圖片路徑 見 E_SDK_ERROR

3.4.拍照（保存圖片base64）

函數原型: int DX_TakePicture(int index, int quality, char **pOutImageBase64,  int *pOutLen, int *pOutWidth, int *pOutHeight) 

函數名 參數 返回值

DX_TakePicture index: 攝像頭索引

quality: 圖片壓縮質量等級0~100

pOutImageBase64: 返回的圖片base64

pOutLen: 返回的圖片base64長度

pOutWidth: 圖片分辨率寬

pOutHeight: 圖片分辨率高 見 E_SDK_ERROR

3.5.拍照（外部傳入路徑）

函數原型:int DX_TakePicturePath2(int index, int quality, char *pInImgPath)

函數名 參數 返回值

DX_TakePicture index: 攝像頭索引

quality: 圖片壓縮質量等級0~100

pInImgPath: 外部傳入的圖片路徑 見 E_SDK_ERROR

3.6.釋放拍照圖片base64 內存

函數原型: int DX_FreeTakePicture(char **pInImage) 

函數名 參數 返回值

DX_FreeTakePicture pInImage: 拍照圖片base64內存 見 E_SDK_ERROR

3.7.關閉攝像頭

函數原型: int DX_CloseCamera(int index) 

函數名 參數 返回值

DX_CloseCamera index: 攝像頭索引 見 E_SDK_ERROR

3.8.獲取攝像頭個數

函數原型: int DX_GetCameraList(int *pCameraCount) 

函數名 參數 返回值

DX_GetCameraList index: 攝像頭索引 見 E_SDK_ERROR

3.9.返回攝像頭名稱

函數原型: int DX_GetCameraName(char ***pOut, int *pOutSize) 

函數名 參數 返回值

DX_GetCameraName pOut: 返回的攝像頭名稱，指針數組

pOutSize: 數組長度 見 E_SDK_ERROR

3.10.釋放攝像頭名稱內存

函數原型: int DX_FreeGetCameraName(char ***p, int nLen) 

函數名 參數 返回值

DX_GetCameraName p: 返回的攝像頭名稱，指針數組

pOutSize: 數組長度 見 E_SDK_ERROR

3.11.獲取分辨率列表（所有攝像頭）

函數原型: int DX_GetResolutionList(char ****pOut, int *pOutSize) 

函數名 參數 返回值

DX_GetResolutionList pOut: 返回的攝像頭名稱，二維指針數組

pOutSize: 數組長度 見 E_SDK_ERROR

3.12.釋放攝像頭分辨率列表內存

函數原型: int DX_FreeGetResolutionList(char ****p, int nLen) 

函數名 參數 返回值

DX_FreeGetResolutionList p: 返回的攝像頭名稱，二維指針數組

nLen: 數組長度 見 E_SDK_ERROR

3.13.獲取當前分辨率

函數原型: int DX_GetResolution(int *pWidth, int *pHeight) 

函數名 參數 返回值

DX_GetResolution pWidth: 分辨率寬

nLen: 分辨率高 見 E_SDK_ERROR

3.14.旋轉

函數原型: int DX_SetRotate() 

函數名 參數 返回值

DX_SetRotate 無 見 E_SDK_ERROR

3.15.沿x軸翻轉

函數原型: int DX_SetXFlip() 

函數名 參數 返回值

DX_SetXFlip 無 見 E_SDK_ERROR

3.16.沿y軸翻轉

函數原型: int DX_SetYFlip() 

函數名 參數 返回值

DX_SetYFlip 無 見 E_SDK_ERROR

3.17.開啟自動裁剪

函數原型: int DX_SetAutoCrop() 

函數名 參數 返回值

DX_SetAutoCrop 無 見 E_SDK_ERROR

3.18.關閉啟動裁剪

函數原型: int DX_CloseAutoCrop() 

函數名 參數 返回值

DX_CloseAutoCrop 無 見 E_SDK_ERROR

3.19.設置自定義裁剪

函數原型: int DX_SetCustomCrop(int x, int y, int width, int height) 

函數名 參數 返回值

DX_SetCustomCrop x：起點x坐標

y: 起點y坐標

width: 寬

height: 高 見 E_SDK_ERROR

3.20.關閉自定義裁剪

函數原型: int DX_CloseCustomCrop() 

函數名 參數 返回值

DX_CloseCustomCrop 無 見 E_SDK_ERROR

3.21.縮小

函數原型: int DX_SetZoomIn() 

函數名 參數 返回值

DX_SetZoomIn 無 見 E_SDK_ERROR

3.22.放大

函數原型: int DX_SetZoomOut() 

函數名 參數 返回值

DX_SetZoomOut 無 見 E_SDK_ERROR

3.23.設置預覽回調

函數原型: int DX_SetPreviewCallback(DX_OnPreviewCallback callback) 

函數名 參數 返回值

DX_SetPreviewCallback callback: 預覽回調函數，見下面原型 見 E_SDK_ERROR

typedef void(DXSDK_CALL *DX_OnPreviewCallback)(char *data);

4.身份證讀取

4.1.讀取身份證

函數原型: int DX_ReadIDCard(char **pOutPdfPath) 

函數名 參數 返回值

DX_ReadIDCard pInPdfPath: 輸出的身份證信息 見 E_SDK_ERROR

4.2.讀取身份證（異步調用）

函數原型: int DX_ReadIDCardWithCallback(DX_OnIDInfoCallback callback) 

函數名 參數 返回值

DX_ReadIDCardWithCallback callback: 身份信息回調，原型見下面 見 E_SDK_ERROR

typedef void(DXSDK_CALL *DX_OnIDInfoCallback)(char *idInfo);

4.3.讀取身份證（后臺）

函數原型: int DX_ReadIDCardWithCallback2(int flags, DX_OnIDInfoCallback callback) 

函數名 參數 返回值

DX_ReadIDCardWithCallback2 flags: 0:開始

1: 暫停

2: 恢復

callback: 身份信息回調，原型見下面 見 E_SDK_ERROR

typedef void(DXSDK_CALL *DX_OnIDInfoCallback)(char *idInfo);

4.4.讀取身份證頭像

函數原型: int DX_GetIDPhoto(char **pOutPhoto, int *pOutLen) 

函數名 參數 返回值

DX_GetIDPhoto pOutPhoto: 身份證頭像

pOutLen: 身份證頭像長度 見 E_SDK_ERROR

4.5.釋放讀取身份證頭像內存

函數原型: int DX_FreeGetIDPhoto(char **pInPhoto) 

函數名 參數 返回值

DX_FreeGetIDPhoto pInPhoto: 身份證頭像 見 E_SDK_ERROR

4.6.讀取身份證指紋數據

函數原型: int DX_GetIDFin(char **pOutFin, int *pOutLen) 

函數名 參數 返回值

DX_FreeGetIDPhoto pOutFin: 身份證指紋數據

pOutLen: 返回的身份證指紋數據長度 見 E_SDK_ERROR

4.7.釋放身份證指紋數據內存

函數原型: int DX_FreeGetIDFin(char **pInFin) 

函數名 參數 返回值

DX_FreeGetIDFin pInFin: 身份證指紋數據 見 E_SDK_ERROR

4.8.停止讀取身份證

函數原型: int DX_StopReadIDCard() 

函數名 參數 返回值

DX_StopReadIDCard 無 見 E_SDK_ERROR

4.9.釋放讀取身份證信息內存

函數原型: int DX_FreeReadIDCard(char **p) 

函數名 參數 返回值

DX_FreeReadIDCard p: 釋放讀取身份證信息內存 見 E_SDK_ERROR

5.指紋讀取

5.1.設置讀取指紋回調函數

函數原型: int DX_SetReadFinImgCallback(DX_OnFinImgCallback callback) 

函數名 參數 返回值

DX_SetReadFinImgCallback callback: 指紋回調函數，原型見下面 見 E_SDK_ERROR

typedef void(DXSDK_CALL *DX_OnFinImgCallback)(char *pFinImgBase64);

5.2.創建指紋模版

函數原型: int DX_CreateTemplate(DX_OnCreateTemplateCallback callback) 

函數名 參數 返回值

DX_CreateTemplate callback: 指紋回調函數，原型見下面 見 E_SDK_ERROR

typedef void(DXSDK_CALL *DX_OnCreateTemplateCallback)(int ErrorCode, char *pFinTemplate, int size);

5.3.指紋特征比對

函數原型: int DX_CompareTemplates(int *matchScore,char* template1,char* template2,int templateSize) 

函數名 參數 返回值

DX_CompareTemplates matchScore: 指紋特征比對評分

template1: 指紋特征1

template2: 指紋特征2

templateSize: 指紋特征長度 見 E_SDK_ERROR

5.4.讀取指紋base64

函數原型: int DX_ReadFinImgData(char **pOutFinImgData, int *pOutLen) 

函數名 參數 返回值

DX_ReadFinImgData pOutFinImgData: 指紋圖片base64數據

pOutLen: 指紋圖片base64輸出長度 見 E_SDK_ERROR

5.5.釋放讀取指紋圖片base64內存

函數原型: int DX_FreeReadFinImgData(char **pInFinImgData) 

函數名 參數 返回值

DX_FreeReadFinImgData pInFinImgData: 指紋圖片base64數據 見 E_SDK_ERROR

5.6.關閉指紋讀取

函數原型: int DX_CloseReadFinImg() 

函數名 參數 返回值

DX_CloseReadFinImg 無 見 E_SDK_ERROR

6.條碼讀取

6.1.讀取條碼信息

函數原型: int DX_BarScan(char *pOutInfo) 

函數名 參數 返回值

DX_BarScan pOutInfo: 條碼信息 見 E_SDK_ERROR

6.2.釋放條碼信息內存

函數原型: int DX_FreeBarScan(char *p) 

函數名 參數 返回值

DX_FreeBarScan p: 條碼信息內存 見 E_SDK_ERROR

7.服務評價

7.1.開始評價

函數原型: int DX_StartEvaluate(int timeout, DX_OnEvaluateCallback callback);

 函數名 參數 返回值

DX_StartEvaluate timeout: 獲取評價超時時間

callback: 評價回調函數，原型見下面 見 E_SDK_ERROR

typedef void(DXSDK_CALL *DX_OnEvaluateCallback)(char *evaluateValue);

7.2.關閉評價

函數原型: int DX_CloseEvaluate() 

函數名 參數 返回值

DX_CloseEvaluate 無 見 E_SDK_ERROR

8.文件簽字

8.1.發起PDF簽字（任意簽）

函數原型: int DX_StartPDFSign(int recordVideo,int timeout, const char *pdfPath, DX_OnPDFSignCallback callback) 

函數名 參數 返回值

DX_StartPDFSign recordVideo: 錄制視頻：0: 不錄制 1: 錄制

timeout: 簽字超時時間

pdfPath: pdf路徑

callback: 簽字回調，原型見下面 見 E_SDK_ERROR

typedef void(DXSDK_CALL *DX_OnPDFSignCallback)(int ErrorCode,char* SignPdfBase64, char* SignNameJson, int SignNameCount,

8.2.關閉PDF簽字

函數原型: int DX_ClosePDFSign() 

函數名 參數 返回值

DX_ClosePDFSign 無 見 E_SDK_ERROR

8.3.開始關鍵字簽字

函數原型: int DX_StartPDFKeywordSign(int timeout,int compose,int width,int height,char *keyword,int keywordCount,const char *title,const char *pdfPath,DX_OnPDFKeyWordCallback callback) 

函數名 參數 返回值

DX_StartPDFKeywordSign timeout: 簽字超時時間

compose: 1: 合成到頁面, 2: 僅展示內容

width: 簽字寬度占頁面的百分比

height: 簽字高度占頁面的百分比

Keyword: 關鍵字數組

keywordCount: 關鍵字數組長度

Title: 標題

pdfPath: pdf文件路徑

callback: 回調函數，原型見下面 見 E_SDK_ERROR

typedef void(DXSDK_CALL *DX_OnPDFKeyWordCallback)(int ErrorCode,char* SignPdfBase64, char*SignNameBase64, char*finPngBase64);

8.4.關閉關鍵字簽字

函數原型: int DX_ClosePDFKeyworkdSign() 

函數名 參數 返回值

DX_ClosePDFKeyworkdSign 無 見 E_SDK_ERROR

8.5.開始圖片簽字

函數原型: int DX_StartImageSign(int timeout,int compose,int left,int top,int width,int height,const char *title,const char *imgPath,DX_OnImageSignCallback callback) 

函數名 參數 返回值

DX_StartImageSign Timeout: 圖片簽字超時時間

Compose: 1：合成到指定圖片上，2： 僅展示不合成

Left: 距離圖片左上角的百分比

Top: 距離圖片頂部的百分比

Width: 簽字寬度占圖片的百分比

Height: 簽字高度占圖片的百分比

Callback: 簽字圖片回調，原型見下面 見 E_SDK_ERROR

typedef void(DXSDK_CALL *DX_OnImageSignCallback)(int ErrorCode, char *imgBase64, char *signImgBase64);

8.6.關閉圖片簽字

函數原型: int DX_CloseImageSign() 

函數名 參數 返回值

DX_CloseImageSign 無 見 E_SDK_ERROR

9.社保卡讀取

9.1.打開社保卡讀卡器

函數原型: int DX_StartReadSSCard(int timeout) 

函數名 參數 返回值

DX_StartReadSSCard timeout: 超時時間 見 E_SDK_ERROR

9.2.讀取基本信息

函數原型: int DX_ReadBasicSSCardInfo(char **pOutSSCardInfo) 

函數名 參數 返回值

DX_ReadBasicSSCardInfo pOutSSCardInfo: 返回社保卡基本信息 見 E_SDK_ERROR

9.3.讀基本信息（回調方式）

函數原型: int DX_ReadBasicSSCardInfoCallback(DX_OnReadSSCardBasicInfoCallback callback) 

函數名 參數 返回值

DX_ReadBasicSSCardInfoCallback callback: 讀取社保卡基本信息回調，原型見下面 見 E_SDK_ERROR

typedef void(DXSDK_CALL *DX_OnReadSSCardBasicInfoCallback)(int ErrorCode, char *pSSCardInfo);

9.4.基于加密機的加密步驟一

函數原型: int DX_ReadSSCardHSM1(char **pOutSSCardInfo) 

函數名 參數 返回值

DX_ReadSSCardHSM1 pOutSSCardInfo:  返回加密讀取步驟一生成的數據 見 E_SDK_ERROR

9.5.基于加密機的加密步驟二

函數原型: int DX_ReadSSCardHSM2(char *pKey, int pKeyLen, char **pOutSSCardInfo) 

函數名 參數 返回值

DX_ReadSSCardHSM2 pKey:  key

pKeyLen:  key長度

pOutSSCardInfo: 返回的社保卡信息 見 E_SDK_ERROR

9.6.釋放社保卡讀取的信息內存

函數原型: int DX_FreeSSCardInfo(char **p) 

函數名 參數 返回值

DX_FreeSSCardInfo p: 返回的社保卡信息內存 見 E_SDK_ERROR

9.7.關閉社保卡讀取

函數原型: int DX_CloseReadSSCard() 

函數名 參數 返回值

DX_CloseReadSSCard 無 見 E_SDK_ERROR

10.人證核驗

10.1.發起人證核驗

函數原型: int DX_StartFaceCompare(int enableAntiSpoofing,int enableQualityCheck,int timeout,DX_OnFaceCompareCallback callback) 

函數名 參數 返回值

DX_StartFaceCompare enableAntiSpoofing: 開啟活體檢測: 0: 不檢測，1：檢測

enableQualityCheck: 開啟質量檢測: 0: 不檢測，1: 檢測

timeout: 超時時間

callback: 回調函數，見下面說明 見 E_SDK_ERROR

typedef void(DXSDK_CALL *DX_OnFaceCompareCallback) (int ErrorCode, char *pOutIDInfoJson);

10.2. 發起人證核驗2

函數原型: int DX_StartFaceCompare(int cameraIndex, int enableAntiSpoofing,int enableQualityCheck,int timeout,DX_OnFaceCompareCallback callback) 

函數名 參數 返回值

DX_StartFaceCompare cameraIndex: 攝像頭索引，即要人證核驗的攝像頭

enableAntiSpoofing: 開啟活體檢測: 0: 不檢測，1：檢測

enableQualityCheck: 開啟質量檢測: 0: 不檢測，1: 檢測

timeout: 超時時間

callback: 回調函數，見下面說明 見 E_SDK_ERROR

typedef void(DXSDK_CALL *DX_OnFaceCompareCallback) (int ErrorCode, char *pOutIDInfoJson);

10.3.關閉人證核驗

函數原型: int DX_CloseFaceCompare() 

函數名 參數 返回值

DX_CloseFaceCompare 無 見 E_SDK_ERROR

11. 工具類

11.1.圖片轉base64

函數原型: int DX_Image2Base64(const char *pImagePath, char **pOutBase64) 

函數名 參數 返回值

DX_Image2Base64 pImagePath: 輸入圖片路徑

pOutBase64: 返回base64 見 E_SDK_ERROR

11.2.釋放圖片轉base64分配的內存

函數原型: int DX_FreeImage2Base64(char **p) 

函數名 參數 返回值

DX_FreeImage2Base64 p: 待釋放的圖片base64內存 見 E_SDK_ERROR

11.3.圖片列表轉PDF

函數原型: int DX_MergePDF(char **pImageArray, const int pLen, int keepRatio, int fullPage, int paddingLeft, int paddingTop, int paddingRight, int paddingBottom, char **pOutPdfPath) 

函數名 參數 返回值

DX_MergePDF pImageArray: 圖片數組

pLen: 圖片數組長度

keepRatio: 0：無 1： 以寬進行縮放，2： 以高進行縮放

fullPage: 0: 無, 1: 縮放到整個頁面

paddingLeft: 左邊距

paddingTop: 上邊距

paddingRight: 右邊距

paddingBottom: 下邊距

pOutPdfPath: 輸出的pdf路徑 見 E_SDK_ERROR

11.4.釋放圖片列表轉PDF路徑的內存

函數原型: int DX_FreeMergePDF(char **pInPdfPath) 

函數名 參數 返回值

DX_FreeMergePDF pInPdfPath: 輸出的pdf路徑內存 見 E_SDK_ERROR