前言
華為HMS MLKit提供的服務越來越多了，上期給大家介紹了銀行卡識別的功能，從上期的介紹中我們可以了解到使用專用的銀行卡識別接口，幾行代碼就可以完成銀行卡卡號的識別，那么有的小伙伴可能會問，我想識別的卡不是銀行卡，會員卡可以識別嗎，或者某一類證件號識別？也沒有問題~但因為不同商家的卡號位置，版面樣式各異，所以無法像銀行卡識別那樣使用專用的銀行卡識別API，這個時候我們可以選用通用卡證識別的能力，通用卡證識別可以給大家提供一個標准的通用卡證對准框，大家只需要拉起這個對准框，就可以獲取對准框內識別到的卡證全部內容，這個時候再針對這些內容按照一定的規則做關鍵信息提取，即可獲取到自己想要的內容，比如連續的8位數字即為卡號，或者在某些特殊字母后的內容即為卡號內容。
通用卡證識別的應用場景
通用卡證識別，顧名思義，是各種卡證的識別，能識別的范圍很廣，常用的應用場景：
- 旅游綁證
旅游類APP需要對身份證等信息進行綁定，用於購票、酒店預訂等場景，通過對此類證件進行拍照自動識別，可以避免手動輸入證件號容易出錯的問題。
- 購物綁卡
購物類APP，通過拍照識別快速綁定會員卡、購物卡、打折卡。
銀行卡、中國二代身份證號碼識別雖然可以也可以使用通用卡證識別來完成，但推薦使用華為ML Kit的專有的銀行卡識別、身份證識別的API，專有卡證識別針對銀行卡、身份證識別做了特別的優化，准確率更高，可以直接返回處理好以后的卡號數據，小編后續可以詳細介紹下專有卡證和通用卡證識別的區別。
如何使用通用卡證識別服務
給大家畫了個簡單的流程圖，可以看到只需要把圖片、拍照、視頻流傳給ML Kit，即可獲取到對應的識別內容，針對識別內容做一定后處理即可提取出要識別的卡證號內容。
集成通用卡證識別服務的關鍵流程
可以看到開發流程也非常的簡單，只需要啟動卡證識別Activity,獲取Activity識別到的內容，然后對內容做簡單后處理提取關鍵信息就可以完成代碼開發了。
核心提示，端側能力全免費，全終端覆蓋！非華為手機也可以使用
開發實戰
本次的開發實戰中實現了對港澳通行證、回鄉證、香港居民身份證的處理，大家伙可參考實現。
1 開發准備
詳細的准備步驟可以參考華為開發者聯盟：
https://developer.huawei.com/consumer/cn/doc/development/HMS-Guides/ml-process-4
這里列舉關鍵的開發步驟。
1.1 在項目級gradle里添加華為maven倉
打開AndroidStudio項目級build.gradle文件，增量添加如下maven地址：
buildscript {
repositories {
maven {url 'http://developer.huawei.com/repo/'}
} }allprojects {
repositories {
maven { url 'http://developer.huawei.com/repo/'}
}}
1.2 在應用級的build.gradle里面加上SDK依賴
dependencies{
// 引入基礎SDK
implementation 'com.huawei.hms:ml-computer-vision-ocr:1.0.3.300'
// 引入拉丁語文字識別模型包
implementation 'com.huawei.hms:ml-computer-vision-ocr-latin-model:1.0.3.300'
// 引入銀行卡識別plugin包
implementation 'com.huawei.hms:ml-computer-card-gcr-plugin:1.0.3.300' }
將以下語句添加到AndroidManifest.xml文件中：
<manifest
...
<meta-data
android:name="com.huawei.hms.ml.DEPENDENCY"
android:value= "ocr"/>
... </manifest>
1.3 配置混淆腳本
按照官網操作指導來就行了：
https://developer.huawei.com/consumer/cn/doc/development/HMS-Guides/ml-configuringobfuscation-scripts-4
1.4 在AndroidManifest.xml文件里面申請相機和存儲權限
都是些基本操作，廢話也不多說，按照官網指導來操作：
https://developer.huawei.com/consumer/cn/doc/development/HMS-Guides/ml-assigning-permissions-4
2 代碼開發
2.1 啟動卡證識別
@Override
public void onClick(View v) {
switch (v.getId()) {
// 相冊圖片檢測按鈕。
case R.id.detect_picture:
this.startLocalImageActivity(cardImage, null, callback);
break;
// 視頻流檢測按鈕。
case R.id.detect_video:
this.startCaptureActivity(null, callback);
break;
// 拍照檢測按鈕。
case R.id.detect_take_photo:
this.startTakePhotoActivity(null, callback);
break;
default:
break;
} }
視頻流識別
private void startCaptureActivity(Object object, MLGcrCapture.Callback callback) {
// 創建通用卡證識別配置器。
MLGcrCaptureConfig cardConfig = new MLGcrCaptureConfig.Factory().create();
// 創建通用卡證識別界面配置器。
MLGcrCaptureUIConfig uiConfig = new MLGcrCaptureUIConfig.Factory()
// 設置掃描框顏色。
.setScanBoxCornerColor(Color.GREEN)
// 設置掃描框中的提示文字，建議少於30個字符。
.setTipText("Recognizing, align edges")
// 設置識別界面橫豎屏，支持三種模式：
// MLGcrCaptureUIConfig.ORIENTATION_AUTO:自動模式，由物理感應器決定顯示方向。
// MLGcrCaptureUIConfig.ORIENTATION_LANDSCAPE:橫屏模式。
// MLGcrCaptureUIConfig.ORIENTATION_PORTRAIT:豎屏模式。
.setOrientation(MLGcrCaptureUIConfig.ORIENTATION_AUTO)
.create();
// 方式一：根據自定義的卡證識別界面配置器，創建通用卡證識別處理器。
MLGcrCapture ocrManager = MLGcrCaptureFactory.getInstance().getGcrCapture(cardConfig, uiConfig);
// 方式二：使用默認界面，創建通用卡證識別處理器。
MLGcrCapture ocrManager = MLGcrCaptureFactory.getInstance().getGcrCapture(cardConfig);
// 綁定通用卡證識別處理器和處理結果回調函數。
ocrManager.capturePreview(this, object, callback); }
拍照識別
private void startTakePhotoActivity(Object object, MLGcrCapture.Callback callback) {
// 創建通用卡證識別配置器。
MLGcrCaptureConfig cardConfig = new MLGcrCaptureConfig.Factory().create();
// 創建通用卡證識別界面配置器。
MLGcrCaptureUIConfig uiConfig = new MLGcrCaptureUIConfig.Factory()
// 設置掃描框顏色。
.setScanBoxCornerColor(Color.BLUE)
// 設置掃描框中的提示文字，建議少於30個字符。
.setTipText("Taking picture, align edges")
// 設置界面橫豎屏，支持三種模式：
// MLGcrCaptureUIConfig.ORIENTATION_AUTO:自動模式，由物理感應器決定顯示方向。
// MLGcrCaptureUIConfig.ORIENTATION_LANDSCAPE:橫屏模式。
// MLGcrCaptureUIConfig.ORIENTATION_PORTRAIT:豎屏模式。
.setOrientation(MLGcrCaptureUIConfig.ORIENTATION_AUTO)
.create();
// 方式一：根據自定義的卡證識別界面配置器，創建通用卡證識別處理器。
MLGcrCapture ocrManager = MLGcrCaptureFactory.getInstance().getGcrCapture(cardConfig, uiConfig);
// 方式二：使用默認界面，創建通用卡證識別處理器。
MLGcrCapture ocrManager = MLGcrCaptureFactory.getInstance().getGcrCapture(cardConfig);
// 綁定通用卡證識別處理器和處理結果回調函數。
ocrManager.capturePhoto(this, object, callback); }
相冊圖片識別
private void startLocalImageActivity(Bitmap bitmap, Object object, MLGcrCapture.Callback callback) {
// 創建通用卡證識別配置器。
MLGcrCaptureConfig config = new MLGcrCaptureConfig.Factory().create();
MLGcrCapture ocrManager = MLGcrCaptureFactory.getInstance().getGcrCapture(config);
// bitmap 為需要識別的Bitmap類型卡證圖像，支持的圖片格式包括：jpg/jpeg/png/bmp。
ocrManager.captureImage(bitmap, object, callback); }
2.2 對識別后的內容做后處理，進行關鍵信息提取
重載onResult， onCanceled， onFailure， onDenied四個方法；onResult表示返回了結果，MLGcrCaptureResult為卡證識別返回的結果，onCanceled 表示用戶取消，onFailure 表示識別失敗，onDenied 表示相機不可用等場景。
private MLGcrCapture.Callback callback = new MLGcrCapture.Callback() {
@Override
public int onResult(MLGcrCaptureResult result, Object object) {
Log.i(TAG, "callback onRecSuccess");
if (result == null) {
Log.e(TAG, "callback onRecSuccess result is null");
return MLGcrCaptureResult.CAPTURE_CONTINUE;
}
GeneralCardProcessor idCard = null;
GeneralCardResult cardResult = null;
/*港澳台通行證處理*/
if (cardTypeEnum == CardType.PASSCARD) {
idCard = new PassCardProcessor(result.text);
/*香港身份證處理*/
} else if (cardTypeEnum == CardType.HKIDCARD) {
idCard = new HKIdCardProcessor(result.text);
/*回鄉證處理*/
} else if (cardTypeEnum == CardType.COMEHOMECARD) {
idCard = new HomeCardProcessor(result.text);
}
if (idCard != null) {
/*獲取處理后的結果*/
cardResult = idCard.getResult();
}
showFrontImage(result.cardBitmap);
displayResult(cardResult);
// If the results don't match
if (cardResult == null || cardResult.valid.isEmpty() || cardResult.number.isEmpty()) {
return MLGcrCaptureResult.CAPTURE_CONTINUE;
}
displayResult(cardResult);
return MLGcrCaptureResult.CAPTURE_STOP;
}
};}
};
具體的卡號提取處理邏輯可以通過重寫GeneralCardProcessor 類中的getResult()方法來完成，以港澳台通行證舉例，更加詳細的處理可以看github上的源碼：
public class PassCardProcessor implements GeneralCardProcessor {
private static final String TAG = "PassCardProcessor";
private final MLText text;
public PassCardProcessor(MLText text) {
this.text = text;
}
@Override
public GeneralCardResult getResult() {
List<MLText.Block> blocks = text.getBlocks();
if (blocks.isEmpty()) {
Log.i(TAG, "Result blocks is empty");
return null;
}
ArrayList<BlockItem> originItems = getOriginItems(blocks);
String valid = "";
String number = "";
boolean validFlag = false;
boolean numberFlag = false;
for (BlockItem item : originItems) {
String tempStr = item.text;
if (!validFlag) {
String result = tryGetValidDate(tempStr);
if (!result.isEmpty()) {
valid = result;
validFlag = true;
}
}
if (!numberFlag) {
String result = tryGetCardNumber(tempStr);
if (!result.isEmpty()) {
number = result;
numberFlag = true;
}
}
}
return new GeneralCardResult(valid, number);
} }
Demo 效果
看下Demo效果如何，是不是還不錯！
github 源碼
源碼已經上傳github，大家也可以在github上一起完善該功能。
github源碼地址：https://github.com/HMS-MLKit/HUAWEI-HMS-MLKit-Sample
通用卡證識別demo代碼路徑：
MLKit-Sample\module-text\src\main\java\com\mlkit\sample\activity\GeneralCardRecognitionActivity.java
更詳細的開發指南參考華為開發者聯盟官網
華為開發者聯盟機器學習服務開發指南
往期鏈接：Android | 教你如何在安卓上實現二代身份證識別，一鍵實名認證
內容來源：https://developer.huawei.com/consumer/cn/forum/topicview?tid=0201226181206630022&fid=18
原作者：AI_talking