Android | 教你如何在安卓上實現通用卡證識別，一鍵各類卡綁定

時間 2020-05-13

原文原文鏈接

前言

華爲HMS MLKit提供的服務愈來愈多了，上期給你們介紹了銀行卡識別的功能，從上期的介紹中咱們能夠了解到使用專用的銀行卡識別接口，幾行代碼就能夠完成銀行卡卡號的識別，那麼有的小夥伴可能會問，我想識別的卡不是銀行卡，會員卡能夠識別嗎，或者某一類證件號識別？也沒有問題~但由於不一樣商家的卡號位置，版面樣式各異，因此沒法像銀行卡識別那樣使用專用的銀行卡識別API，這個時候咱們能夠選用通用卡證識別的能力，通用卡證識別能夠給你們提供一個標準的通用卡證對準框，你們只須要拉起這個對準框，就能夠獲取對準框內識別到的卡證所有內容，這個時候再針對這些內容按照必定的規則作關鍵信息提取，便可獲取到本身想要的內容，好比連續的8位數字即爲卡號，或者在某些特殊字母后的內容即爲卡號內容。html

通用卡證識別的應用場景

通用卡證識別，顧名思義，是各類卡證的識別，能識別的範圍很廣，經常使用的應用場景：java

旅遊綁證
旅遊類APP須要對身份證等信息進行綁定，用於購票、酒店預訂等場景，經過對此類證件進行拍照自動識別，能夠避免手動輸入證件號容易出錯的問題。

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

銀行卡、中國二代身份證號碼識別雖然能夠也可使用通用卡證識別來完成，但推薦使用華爲ML Kit的專有的銀行卡識別、身份證識別的API，專有卡證識別針對銀行卡、身份證識別作了特別的優化，準確率更高，能夠直接返回處理好之後的卡號數據，小編後續能夠詳細介紹下專有卡證和通用卡證識別的區別。android

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

給你們畫了個簡單的流程圖，能夠看到只須要把圖片、拍照、視頻流傳給ML Kit，便可獲取到對應的識別內容，針對識別內容作必定後處理便可提取出要識別的卡證號內容。git

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

能夠看到開發流程也很是的簡單，只須要啓動卡證識別Activity,獲取Activity識別到的內容，而後對內容作簡單後處理提取關鍵信息就能夠完成代碼開發了。github

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

開發實戰

本次的開發實戰中實現了對港澳通行證、回鄉證、香港居民身份證的處理，你們夥可參考實現。maven

1 開發準備

詳細的準備步驟能夠參考華爲開發者聯盟：
https://developer.huawei.com/consumer/cn/doc/development/HMS-Guides/ml-process-4ide

這裏列舉關鍵的開發步驟。函數

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);
    } }