標(biāo)題前言

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

通用卡證識(shí)別的應(yīng)用場(chǎng)景

通用卡證識(shí)別，顧名思義，是各種卡證的識(shí)別，能識(shí)別的范圍很廣，常用的應(yīng)用場(chǎng)景：
旅游綁證
旅游類APP需要對(duì)身份證等信息進(jìn)行綁定，用于購(gòu)票、酒店預(yù)訂等場(chǎng)景，通過對(duì)此類證件進(jìn)行拍照自動(dòng)識(shí)別，可以避免手動(dòng)輸入證件號(hào)容易出錯(cuò)的問題

購(gòu)物綁卡
購(gòu)物類APP，通過拍照識(shí)別快速綁定會(huì)員卡、購(gòu)物卡、打折卡。

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

如何使用通用卡證識(shí)別服務(wù)

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

集成通用卡證識(shí)別服務(wù)的關(guān)鍵流程

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

核心提示，端側(cè)能力全免費(fèi)，全終端覆蓋！非華為手機(jī)也可以使用

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

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

1 開發(fā)準(zhǔn)備

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

1.1 在項(xiàng)目級(jí)gradle里添加華為maven倉(cāng)
打開AndroidStudio項(xiàng)目級(jí)build.gradle文件，增量添加如下maven地址：

buildscript {repositories { maven {url 'http://developer.huawei.com/repo/'}} }allprojects {repositories { maven { url 'http://developer.huawei.com/repo/'}}}

1.2 在應(yīng)用級(jí)的build.gradle里面加上SDK依賴

dependencies{ // 引入基礎(chǔ)SDK implementation 'com.huawei.hms:ml-computer-vision-ocr:1.0.3.300' // 引入拉丁語(yǔ)文字識(shí)別模型包 implementation 'com.huawei.hms:ml-computer-vision-ocr-latin-model:1.0.3.300' // 引入銀行卡識(shí)別plugin包 implementation 'com.huawei.hms:ml-computer-card-gcr-plugin:1.0.3.300' }

將以下語(yǔ)句添加到AndroidManifest.xml文件中：

<manifest ... <meta-data android:name="com.huawei.hms.ml.DEPENDENCY" android:value= "ocr"/> ... </manifest>

1.3 配置混淆腳本
按照官網(wǎng)操作指導(dǎo)來就行了：
https://developer.huawei.com/consumer/cn/doc/development/HMS-Guides/ml-configuringobfuscation-scripts-4
1.4 在AndroidManifest.xml文件里面申請(qǐng)相機(jī)和存儲(chǔ)權(quán)限
都是些基本操作，廢話也不多說，按照官網(wǎng)指導(dǎo)來操作：
https://developer.huawei.com/consumer/cn/doc/development/HMS-Guides/ml-assigning-permissions-4

2 代碼開發(fā)

2.1 啟動(dòng)卡證識(shí)別

@Override public void onClick(View v) { switch (v.getId()) { // 相冊(cè)圖片檢測(cè)按鈕。 case R.id.detect_picture: this.startLocalImageActivity(cardImage, null, callback); break; // 視頻流檢測(cè)按鈕。 case R.id.detect_video: this.startCaptureActivity(null, callback); break; // 拍照檢測(cè)按鈕。 case R.id.detect_take_photo: this.startTakePhotoActivity(null, callback); break; default: break; } }

視頻流識(shí)別

private void startCaptureActivity(Object object, MLGcrCapture.Callback callback) { // 創(chuàng)建通用卡證識(shí)別配置器。 MLGcrCaptureConfig cardConfig = new MLGcrCaptureConfig.Factory().create(); // 創(chuàng)建通用卡證識(shí)別界面配置器。 MLGcrCaptureUIConfig uiConfig = new MLGcrCaptureUIConfig.Factory() // 設(shè)置掃描框顏色。 .setScanBoxCornerColor(Color.GREEN) // 設(shè)置掃描框中的提示文字，建議少于30個(gè)字符。 .setTipText("Recognizing, align edges") // 設(shè)置識(shí)別界面橫豎屏，支持三種模式： // MLGcrCaptureUIConfig.ORIENTATION_AUTO:自動(dòng)模式，由物理感應(yīng)器決定顯示方向。 // MLGcrCaptureUIConfig.ORIENTATION_LANDSCAPE:橫屏模式。 // MLGcrCaptureUIConfig.ORIENTATION_PORTRAIT:豎屏模式。 .setOrientation(MLGcrCaptureUIConfig.ORIENTATION_AUTO) .create(); // 方式一：根據(jù)自定義的卡證識(shí)別界面配置器，創(chuàng)建通用卡證識(shí)別處理器。 MLGcrCapture ocrManager = MLGcrCaptureFactory.getInstance().getGcrCapture(cardConfig, uiConfig); // 方式二：使用默認(rèn)界面，創(chuàng)建通用卡證識(shí)別處理器。 MLGcrCapture ocrManager = MLGcrCaptureFactory.getInstance().getGcrCapture(cardConfig); // 綁定通用卡證識(shí)別處理器和處理結(jié)果回調(diào)函數(shù)。 ocrManager.capturePreview(this, object, callback); }

拍照識(shí)別

private void startTakePhotoActivity(Object object, MLGcrCapture.Callback callback) { // 創(chuàng)建通用卡證識(shí)別配置器。 MLGcrCaptureConfig cardConfig = new MLGcrCaptureConfig.Factory().create(); // 創(chuàng)建通用卡證識(shí)別界面配置器。 MLGcrCaptureUIConfig uiConfig = new MLGcrCaptureUIConfig.Factory() // 設(shè)置掃描框顏色。 .setScanBoxCornerColor(Color.BLUE) // 設(shè)置掃描框中的提示文字，建議少于30個(gè)字符。 .setTipText("Taking picture, align edges") // 設(shè)置界面橫豎屏，支持三種模式： // MLGcrCaptureUIConfig.ORIENTATION_AUTO:自動(dòng)模式，由物理感應(yīng)器決定顯示方向。 // MLGcrCaptureUIConfig.ORIENTATION_LANDSCAPE:橫屏模式。 // MLGcrCaptureUIConfig.ORIENTATION_PORTRAIT:豎屏模式。 .setOrientation(MLGcrCaptureUIConfig.ORIENTATION_AUTO) .create(); // 方式一：根據(jù)自定義的卡證識(shí)別界面配置器，創(chuàng)建通用卡證識(shí)別處理器。 MLGcrCapture ocrManager = MLGcrCaptureFactory.getInstance().getGcrCapture(cardConfig, uiConfig); // 方式二：使用默認(rèn)界面，創(chuàng)建通用卡證識(shí)別處理器。 MLGcrCapture ocrManager = MLGcrCaptureFactory.getInstance().getGcrCapture(cardConfig); // 綁定通用卡證識(shí)別處理器和處理結(jié)果回調(diào)函數(shù)。 ocrManager.capturePhoto(this, object, callback); }

相冊(cè)圖片識(shí)別

private void startLocalImageActivity(Bitmap bitmap, Object object, MLGcrCapture.Callback callback) { // 創(chuàng)建通用卡證識(shí)別配置器。 MLGcrCaptureConfig config = new MLGcrCaptureConfig.Factory().create(); MLGcrCapture ocrManager = MLGcrCaptureFactory.getInstance().getGcrCapture(config); // bitmap 為需要識(shí)別的Bitmap類型卡證圖像，支持的圖片格式包括：jpg/jpeg/png/bmp。 ocrManager.captureImage(bitmap, object, callback); }

2.2 對(duì)識(shí)別后的內(nèi)容做后處理，進(jìn)行關(guān)鍵信息提取
重載onResult， onCanceled， onFailure， onDenied四個(gè)方法；onResult表示返回了結(jié)果，MLGcrCaptureResult為卡證識(shí)別返回的結(jié)果，onCanceled 表示用戶取消，onFailure 表示識(shí)別失敗，onDenied 表示相機(jī)不可用等場(chǎng)景。

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;/*港澳臺(tái)通行證處理*/ 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) {/*獲取處理后的結(jié)果*/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;} };} };

具體的卡號(hào)提取處理邏輯可以通過重寫GeneralCardProcessor 類中的getResult()方法來完成，以港澳臺(tái)通行證舉例，更加詳細(xì)的處理可以看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效果如何，是不是還不錯(cuò)！

github 源碼

源碼已經(jīng)上傳github，大家也可以在github上一起完善該功能。
github源碼地址：https://github.com/HMS-MLKit/HUAWEI-HMS-MLKit-Sample
通用卡證識(shí)別demo代碼路徑：
MLKit-Sample\module-text\src\main\java\com\mlkit\sample\activity\GeneralCardRecognitionActivity.java

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

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

總結(jié)

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

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