標題前言

華為HMS MLKit提供的服務越來越多了，除常見的了銀行卡識別的功能，大家可能還會疑問日常生活中的銀行卡，會員卡可以識別嗎，或者某一類證件號識別？也沒有問題~但因為不同商家的卡號位置，版面樣式各異，所以無法像銀行卡識別那樣使用專用的銀行卡識別API，這個時候我們可以選用通用卡證識別的能力，通用卡證識別可以給大家提供一個標準的通用卡證對準框，大家只需要拉起這個對準框，就可以獲取對準框內(nèi)識別到的卡證全部內(nèi)容，這個時候再針對這些內(nèi)容按照一定的規(guī)則做關鍵信息提取，即可獲取到自己想要的內(nèi)容，比如連續(xù)的8位數(shù)字即為卡號，或者在某些特殊字母后的內(nèi)容即為卡號內(nèi)容。

通用卡證識別的應用場景

通用卡證識別，顧名思義，是各種卡證的識別，能識別的范圍很廣，常用的應用場景：
旅游綁證
旅游類APP需要對身份證等信息進行綁定，用于購票、酒店預訂等場景，通過對此類證件進行拍照自動識別，可以避免手動輸入證件號容易出錯的問題

購物綁卡
購物類APP，通過拍照識別快速綁定會員卡、購物卡、打折卡。

銀行卡、中國二代身份證號碼識別雖然可以也可以使用通用卡證識別來完成，但推薦使用華為ML Kit的專有的銀行卡識別、身份證識別的API，專有卡證識別針對銀行卡、身份證識別做了特別的優(yōu)化，準確率更高，可以直接返回處理好以后的卡號數(shù)據(jù)，小編后續(xù)可以詳細介紹下專有卡證和通用卡證識別的區(qū)別。

如何使用通用卡證識別服務

給大家畫了個簡單的流程圖，可以看到只需要把圖片、拍照、視頻流傳給ML Kit，即可獲取到對應的識別內(nèi)容，針對識別內(nèi)容做一定后處理即可提取出要識別的卡證號內(nèi)容。

集成通用卡證識別服務的關鍵流程

可以看到開發(fā)流程也非常的簡單，只需要啟動卡證識別Activity,獲取Activity識別到的內(nèi)容，然后對內(nèi)容做簡單后處理提取關鍵信息就可以完成代碼開發(fā)了。

核心提示，端側能力全免費，全終端覆蓋！非華為手機也可以使用

開發(fā)實戰(zhàn)

本次的開發(fā)實戰(zhàn)中實現(xiàn)了對港澳通行證、回鄉(xiāng)證、香港居民身份證的處理，大家伙可參考實現(xiàn)。

1 開發(fā)準備

詳細的準備步驟可以參考華為開發(fā)者聯(lián)盟：
https://developer.huawei.com/consumer/cn/doc/development/HMS-Guides/ml-process-4
這里列舉關鍵的開發(fā)步驟。

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 配置混淆腳本
按照官網(wǎng)操作指導來就行了：
https://developer.huawei.com/consumer/cn/doc/development/HMS-Guides/ml-configuringobfuscation-scripts-4
1.4 在AndroidManifest.xml文件里面申請相機和存儲權限
都是些基本操作，廢話也不多說，按照官網(wǎng)指導來操作：
https://developer.huawei.com/consumer/cn/doc/development/HMS-Guides/ml-assigning-permissions-4

2 代碼開發(fā)

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) { // 創(chuàng)建通用卡證識別配置器。 MLGcrCaptureConfig cardConfig = new MLGcrCaptureConfig.Factory().create(); // 創(chuàng)建通用卡證識別界面配置器。 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(); // 方式一：根據(jù)自定義的卡證識別界面配置器，創(chuàng)建通用卡證識別處理器。 MLGcrCapture ocrManager = MLGcrCaptureFactory.getInstance().getGcrCapture(cardConfig, uiConfig); // 方式二：使用默認界面，創(chuàng)建通用卡證識別處理器。 MLGcrCapture ocrManager = MLGcrCaptureFactory.getInstance().getGcrCapture(cardConfig); // 綁定通用卡證識別處理器和處理結果回調(diào)函數(shù)。 ocrManager.capturePreview(this, object, callback); }

拍照識別

private void startTakePhotoActivity(Object object, MLGcrCapture.Callback callback) { // 創(chuàng)建通用卡證識別配置器。 MLGcrCaptureConfig cardConfig = new MLGcrCaptureConfig.Factory().create(); // 創(chuàng)建通用卡證識別界面配置器。 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(); // 方式一：根據(jù)自定義的卡證識別界面配置器，創(chuàng)建通用卡證識別處理器。 MLGcrCapture ocrManager = MLGcrCaptureFactory.getInstance().getGcrCapture(cardConfig, uiConfig); // 方式二：使用默認界面，創(chuàng)建通用卡證識別處理器。 MLGcrCapture ocrManager = MLGcrCaptureFactory.getInstance().getGcrCapture(cardConfig); // 綁定通用卡證識別處理器和處理結果回調(diào)函數(shù)。 ocrManager.capturePhoto(this, object, callback); }

相冊圖片識別

private void startLocalImageActivity(Bitmap bitmap, Object object, MLGcrCapture.Callback callback) { // 創(chuàng)建通用卡證識別配置器。 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 對識別后的內(nèi)容做后處理，進行關鍵信息提取
重載onResult， onCanceled， onFailure， onDenied四個方法；onResult表示返回了結果，MLGcrCaptureResult為卡證識別返回的結果，onCanceled 表示用戶取消，onFailure 表示識別失敗，onDenied 表示相機不可用等場景。

private MLGcrCapture.Callback callback = new MLGcrCapture.Callback() {@Overridepublic 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);/*回鄉(xiāng)證處理*/} 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 matchif (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;}@Overridepublic 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 源碼

源碼已經(jīng)上傳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

更詳細的開發(fā)指南參考華為開發(fā)者聯(lián)盟官網(wǎng)

華為開發(fā)者聯(lián)盟機器學習服務開發(fā)指南：
https://developer.huawei.com/consumer/cn/doc/development/HMS-Guides/ml-introduction-4

總結

以上是生活随笔為你收集整理的超简单集成华为HMS Core MLKit通用卡证识别SDK，一键实现各种卡绑定的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。