101

附錄一 Android 接口參數(shù)描述

1 授權(quán)類型表（用于初始化核心的參5）

校驗類型 id（十六進制） 校驗信息

設(shè)備序列號 0x01 校驗硬件設(shè)備號

項目（舊版不推薦） 0x02 校驗包名和應(yīng)用名

項目（新版推薦） 0x03 只校驗包名

注：校驗類型三選其一。信息校驗失敗，初始化核心會激活

失敗，返回錯誤碼24

2 產(chǎn)品類型表（用于初始化核心的參4）

類型 id（十六進制） 備注

銀行卡 0x04 簡稱Bank

二代證正面 0x02 簡稱SIDCard

駕駛證 0x07 簡稱DL

行駛證 0x05 簡稱VL

機動車車輛識別代號 0x01 簡稱VIN

車牌 0x06 簡稱Plate

注：類型不匹配，初始化核心會激活失敗，返回錯誤碼20

3 相機掃描識別狀態(tài)錯誤描述

public native int ScanStreamNV21(byte[] streamnv21, int cols, int raws, int

[]Line,char[] cardno, int []wrapdata);

102

此接口基于NV21字節(jié)流識別，返回0代表成功，其他值表示未發(fā)現(xiàn)銀行卡

如果長時間不識別，并且銀行卡很清晰，

public native void SetRegion (int left,int top,int right,int bottom);

設(shè)置識別區(qū)域不正確

103

附錄二 常見問題

（激活失敗問題請參考對應(yīng) OCR 產(chǎn)品的錯誤碼表）

Android 部分：

問題一: 集成配置后報錯，erro 為導(dǎo)入 module 沖突

解決辦法: 有一個 module 模塊使用 implementation 或 compile 方式引入（如

圖 1）

其他模塊都使用 compileOnly 或 provided 方式應(yīng)用 jar 包（如圖 2）

implementation /compile

implementation 和 compile 是對所有的 build type 以及 favlors 都會參與編譯

并且打包到最終的 apk 文件中。

compileOnly/provided :

compileOnly 和 provided 是對所有的 build type 以及 favlors 只在編譯時使用，

不打包到最終 apk。

只需一個 jar 包被打包到 apk 就可以，其他 jar 包只在編譯時使用

問題二：能激活成功，但一直識別失敗，不識別

解決辦法： 這個接口 EtSetPlateROI，識別區(qū)域設(shè)置的與顯示的不一致。如有問

題，聯(lián)系 OCR 廠商技術(shù)支持。

問題三：識別過慢,但是 demo 中識別速度沒有影響

104

解決辦法: 一般是對應(yīng)的 cpu 類型設(shè)置不對，jnilibs 文件下的.so 文件配置錯誤

問題四：崩潰,erro 錯誤為沒有 imei 授權(quán)

解決辦法： 在項目中 manifest 文件中配置授權(quán),以及進行權(quán)限申請

問題五: 手持機等非手機 android 設(shè)備識別，不穩(wěn)定(識別時間長，偶爾識別等

問題)

解決辦法: 1) 適配問題 2) cpu 類型配置不對(問題三類似)

問題六: 多次初始化以及釋放之后進行多次初始化導(dǎo)致核心崩潰

Erro : fatal singal 6 (SIGABRT) ,code -6(si_tkill)int tid

解決辦法: 避免多次初始化和釋放,切記和 activity 生命周期進行綁定,不推薦用

fragment 的生命周期進行綁定初始化和釋放 api 的方法.問題七: 是否可以使用 nv21 格式數(shù)據(jù)轉(zhuǎn)化為 jpeg 格式去使用圖片識別接口?

解決辦法: 可以，但是需要注意有些對分辨率要求高的識別產(chǎn)品，則不建議使用

原因 : 因為相機預(yù)覽分辨率也就是 nv21 數(shù)據(jù)分辨率較低，而拍照的數(shù)據(jù)分辨率

較高這一點可能會影響識別效果.問題八：我的產(chǎn)品是哪個版本？

方法一：看 SDK 開發(fā)包壓縮包的名字。（以二代證為例）

方法二：在核心 API 中

iOS 部分：

105

問題一：Archieve 打包報錯

ld: bitcode bundle could not be generated because 'XXX' was built without full

bitcode. All object files and libraries for bitcode must be generated from Xcode

Archive or Install build for architecture armv7

解決辦法：Targets -> Build Settings -> Build Options -> Enable Bitcode -> NO

禁用 Bitcode 即可。

對于 iOS，bitcode 是可選的。

對于 watchOS，bitcode 是必須的。

Mac OS 不支持 bitcode。

一般情況下 Bitcode 禁用沒有什么影響。若您需要支持 Bitcode 的核心庫，請聯(lián)

系 SDK 供應(yīng)商單獨編譯。

問題二：Init Error xx(錯誤碼)

激活錯誤參考產(chǎn)品對應(yīng)的錯誤碼表，表中有對應(yīng)的解決辦法。

問題三：我的產(chǎn)品是哪個版本？

方法一：看 SDK 開發(fā)包壓縮包的名字。（以二代證為例）

方法二：NSLog 打印核心(xxx.a 對應(yīng)的.h)的 sdkVersion 查看。(以二代證、銀行卡為例)

106

107

附錄三 權(quán)限說明

Android：

·<uses-permission android:name=\"android.permission.CAMERA\"/>

調(diào)用相機進行相機預(yù)覽掃描/拍照，識別相機中預(yù)覽/拍照數(shù)據(jù)

·<uses-permission

android:name=\"android.permission.READ_EXTERNAL_STORAGE\"/>

從相冊選擇圖片識別，需要讀取 SD 卡權(quán)限

·<uses-permission

android:name=\"android.permission.WRITE_EXTERNAL_STORAGE\"/>

保存識別后的裁切圖片，需要寫入 SD 卡權(quán)限

·<uses-permission android:name=\"android.permission.VIBRATE\"/>

掃描識別成功，震動提示，需要震動權(quán)限

·<uses-permission android:name=\"android.permission.READ_PHONE_STATE\"/>

讀取手機設(shè)備權(quán)限(SD 卡授權(quán)需要。普通授權(quán)可忽略)

iOS：

·相機權(quán)限：NSCameraUsageDescription

打開相機所需權(quán)限(視頻流識別、拍照識別用到)。

·相冊權(quán)限：NSPhotoLibraryUsageDescription

iOS10 打開相冊選擇圖片所需權(quán)限(導(dǎo)入識別用到)