# 前言
  華為HMS MLKit提供的服務越來越多了，上期給大家介紹了銀行卡識別的功能，從上期的介紹中我們可以瞭解到使用專用的銀行卡識別介面，幾行程式碼就可以完成銀行卡卡號的識別，那麼有的小夥伴可能會問，我想識別的卡不是銀行卡，會員卡可以識別嗎，或者某一類證件號識別？也沒有問題~但因為不同商家的卡號位置，版面樣式各異，所以無法像銀行卡識別那樣使用專用的銀行卡識別API，這個時候我們可以選用通用卡證識別的能力，通用卡證識別可以給大家提供一個標準的通用卡證對準框，大家只需要拉起這個對準框，就可以獲取對準框內識別到的卡證全部內容，這個時候再針對這些內容按照一定的規則做關鍵資訊提取，即可獲取到自己想要的內容，比如連續的8位數字即為卡號，或者在某些特殊字母后的內容即為卡號內容。

# 通用卡證識別的應用場景
  通用卡證識別，顧名思義，是各種卡證的識別，能識別的範圍很廣，常用的應用場景：
- 旅遊綁證
旅遊類APP需要對身份證等資訊進行繫結，用於購票、酒店預訂等場景，透過對此類證件進行拍照自動識別，可以避免手動輸入證件號容易出錯的問題。

![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20200422090113482.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center)

- 購物綁卡
購物類APP，透過拍照識別快速繫結會員卡、購物卡、打折卡。

![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20200422090425620.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center)
>銀行卡、中國二代身份證號碼識別雖然可以也可以使用通用卡證識別來完成，但推薦使用華為ML Kit的專有的銀行卡識別、身份證識別的API，專有卡證識別針對銀行卡、身份證識別做了特別的最佳化，準確率更高，可以直接返回處理好以後的卡號資料，小編後續可以詳細介紹下專有卡證和通用卡證識別的區別。

# 如何使用通用卡證識別服務
![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20200422091000816.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center)
  給大家畫了個簡單的流程圖，可以看到只需要把圖片、拍照、影片流傳給ML Kit，即可獲取到對應的識別內容，針對識別內容做一定後處理即可提取出要識別的卡證號內容。

# 整合通用卡證識別服務的關鍵流程
![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20200422091228739.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center)
  可以看到開發流程也非常的簡單，只需要啟動卡證識別Activity,獲取Activity識別到的內容，然後對內容做簡單後處理提取關鍵資訊就可以完成程式碼開發了。

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

# 開發實戰
  本次的開發實戰中實現了對港澳通行證、回鄉證、香港居民身份證的處理，大傢伙可參考實現。

## 1 開發準備
詳細的準備步驟可以參考華為開發者聯盟：
[https://developer.huawei.com/consumer/cn/doc/development/HMS-Guides/ml-process-4](https://developer.huawei.com/consumer/cn/doc/development/HMS-Guides/ml-process-4)

這裡列舉關鍵的開發步驟。

### 1.1 在專案級gradle裡新增華為maven倉
  開啟AndroidStudio專案級build.gradle檔案，增量新增如下maven地址：

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

### 1.2 在應用級的build.gradle裡面加上SDK依賴
```java
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檔案中：
```java
<manifest ...="" 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](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](https://developer.huawei.com/consumer/cn/doc/development/HMS-Guides/ml-assigning-permissions-4)

## 2 程式碼開發
### 2.1 啟動卡證識別
```java
@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; 
        } }
```
影片流識別

```java
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); }
```
拍照識別

```java
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); }
```
相簿圖片識別

```java
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 表示相機不可用等場景。

```java
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上的原始碼：

```java
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效果如何，是不是還不錯！
![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20200422092443429.gif#pic_center)

# github 原始碼
原始碼已經上傳github，大家也可以在github上一起完善該功能。
github原始碼地址：[https://github.com/HMS-MLKit/HUAWEI-HMS-MLKit-Sample](https://github.com/HMS-MLKit/HUAWEI-HMS-MLKit-Sample)

通用卡證識別demo程式碼路徑：
MLKit-Sample\module-text\src\main\java\com\mlkit\sample\activity\GeneralCardRecognitionActivity.java

**更詳細的開發指南參考華為開發者聯盟官網**
[華為開發者聯盟機器學習服務開發指南](https://developer.huawei.com/consumer/cn/doc/development/HMS-Guides/ml-introduction-4)

---
往期連結：[Android | 教你如何在安卓上實現二代身份證識別，一鍵實名認證](http://blog.itpub.net/69970551/viewspace-2691672/)
內容來源：[https://developer.huawei.com/consumer/cn/forum/topicview?tid=0201226181206630022&fid=18](https://developer.huawei.com/consumer/cn/forum/topicview?tid=0201226181206630022&fid=18)
原作者：AI_talking</blockitem></mltext.block>

Android | 教你如何在安卓上實現通用卡證識別，一鍵各種卡繫結

相關文章