# 前言
  就在近期華為HMS ML Kit 釋出了1.0.3.30版本，ML Kit在原有通用OCR功能的基礎上，又新增了銀行卡識別(BCR)和二代身份證識別(ICR)。今天小編就給大家介紹一下其中的ICR能力。ML kit不僅提供語言相關的AI能力，還提供視覺方向的AI能力，具體資訊大家可以移步[https://developer.huawei.com/consumer/cn/hms/huawei-mlkit](https://developer.huawei.com/consumer/cn/hms/huawei-mlkit)

---

# 場景
  作為一個有身份的人，進行身份認證自然不可避免。平時，我們買火車票、飛機票需要身份認證，住酒店、住賓館需要身份認證，現在連打遊戲都要做實名認證。雖然我們很樂意證明我們自己的身份，但是每次都要輸入那18位長的要命的身份證號，腦子一點不清晰，手一抖就會出錯。因此，使用二代身份證識別(ICR)掃描身份證，做身份資訊的錄入實在是相當方便。

**旅遊出行類app進行身份認證**

**遊戲類app進行身份認證**

**任何需要進行身份認證的app，發揮你的想象力^_^**

---
  現在是不是躍躍欲試，想要自己開發實現啦？那我就廢話不多說，給大家介紹一下簡單整合的ML kit 實現ICR的步驟~~

# 開發前準備
## android studio 安裝
  很簡單，下載安裝即可。具體下載連結：

**Android studio 官網下載連結：[https://developer.android.com/studio](https://developer.android.com/studio)**

**Android studio安裝流程參考連結：[https://www.cnblogs.com/xiadewang/p/7820377.html](https://www.cnblogs.com/xiadewang/p/7820377.html)**

## 在專案級gradle裡新增華為maven倉
  開啟AndroidStudio專案級build.gradle檔案

![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20200421152315398.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center)
  增量新增如下maven地址：

```java
buildscript {
   repositories {        
       maven {url 'http://developer.huawei.com/repo/'}
   }    
}
allprojects {
   repositories {      
       maven { url 'http://developer.huawei.com/repo/'}
   }
}
```
## 在應用級的build.gradle裡面加上SDK依賴
![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20200421152620879.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center)

```java
dependencies{  
 // 引入基礎SDK
 implementation 'com.huawei.hms:ml-computer-vision-icr:1.0.3.300'
 // 引入身份證識別plugin包
 implementation 'com.huawei.hms:ml-computer-card-icr-cn-plugin:1.0.3.315'
 // 引入身份證識別模型包
 implementation 'com.huawei.hms:ml-computer-card-icr-cn-model:1.0.3.315'
}
```
## 在AndroidManifest.xml檔案裡面增量新增模型自動下載
  要使應用程式能夠在使用者從華為應用市場安裝您的應用程式後，自動將最新的機器學習模型更新到使用者裝置，請將以下語句新增到該應用程式的AndroidManifest.xml檔案中：

```java
<manifest ...="" android:name="com.huawei.hms.ml.DEPENDENCY" android:value="icr"></manifest>
         
   ...

```

## 在AndroidManifest.xml檔案裡面申請相機、訪問網路和儲存許可權
```java

<uses-permission android:name="android.permission.CAMERA"></uses-permission>

<uses-permission android:name="android.permission.INTERNET"></uses-permission>

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"></uses-permission>

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"></uses-permission>
```
---

# 程式碼開發關鍵步驟
  在開發時可以透過三種方式進行整合開發，分別為：使用識別外掛進行影片流身份證識別、裝置側身份證識別以及雲側身份證識別。在這裡我們主要介紹使用識別外掛進行影片流身份證識別的開發步驟，如果大家對另外兩種整合方式感興趣，可以參照華為開發者聯盟開發步驟：[https://developer.huawei.com/consumer/en/doc/development/HMS-Guides/ml-icr-dev-4](https://developer.huawei.com/consumer/en/doc/development/HMS-Guides/ml-icr-dev-4)

## 建立識別結果回撥函式
  識別結果回撥函式，過載onSuccess， onCanceled， onFailure， onDenied四個方法；onSuccess 表示識別成功，MLCnIcrCaptureResult為識別返回結果，onCanceled 表示使用者取消，onFailure 表示識別失敗，onDenied 表示相機不可用等場景。

```java
private MLCnIcrCapture.Callback idCallback = new MLCnIcrCapture.Callback() {
   @Override
   public void onSuccess(MLCnIcrCaptureResult idCardResult){
       // 識別成功處理。
   }  
   @Override
   public void onCanceled(){
       // 使用者取消處理。
   }  
   // 識別不到任何文字資訊或識別過程發生系統異常的回撥方法。
   // retCode：錯誤碼。
   // bitmap：檢測失敗的身份證圖片。
   @Override
   public void onFailure(int retCode, Bitmap bitmap){
       // 識別異常處理。
   }
   @Override
   public void onDenied(){
       // 相機不支援等場景處理。
   }  
}
```
## 設定識別引數
  設定識別引數，呼叫識別器capture介面進行識別，識別結果會透過步驟1的回撥函式返回。

```java
private void startCaptureActivity(MLCnIcrCapture.Callback callback, boolean isFront, boolean isRemote) {
   MLCnIcrCaptureConfig config = new MLCnIcrCaptureConfig.Factory()
       // 設定識別身份證的正反面。
       // true：正面。
       // false：反面。
       .setFront(true)
       // 設定是否使用雲側能力進行識別。
       // true：雲側。
       // false：端側。
       .setRemote(false)
       .create();
   MLCnIcrCapture icrCapture = MLCnIcrCaptureFactory.getInstance().getIcrCapture(config);
   icrCapture.capture(callback, this);
}
```

## 實現身份識別
  在檢測按鈕的回撥中，呼叫步驟2中定義的方法，實現身份證識別。

```java
@Override
public void onClick(View v) {
   switch (v.getId()) {
       // 識別正面按鈕。
       case R.id.IDCard_image_front:
           startCaptureActivity(idCallback, true, false);
           break;
       // 識別背面按鈕。
       case R.id.IDCard_image_back:
           startCaptureActivity(idCallBack, false, false);
           break;
       default:
           break;
   }
}
```

---
# Demo效果
  這個demo是識別身份證正反兩面的關鍵資訊，效果如下：

![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20200421153333887.gif#pic_center)

---
往期連結：[DevEco Studio使用指南--平行視界](http://blog.itpub.net/69970551/viewspace-2690894/)
內容來源：[https://developer.huawei.com/consumer/cn/forum/topicview?tid=0201226149614940020&fid=18](https://developer.huawei.com/consumer/cn/forum/topicview?tid=0201226149614940020&fid=18)
原作者：littlewhite

Android | 教你如何在安卓上實現二代身份證識別，一鍵實名認證

相關文章