## 前言

現如今，人際交往成為生活中必不可少的一部分，之間互相傳遞名片，記錄聯絡資訊，是必要的一步，名片承擔著對方的各種資訊，姓名、公司、地址等等，一般情況下，我們會比對著錄入名片上的各種資訊，一個個地敲擊手機鍵盤。如果有了名片識別，就可以扭轉這種現象，輕鬆完成名片識別，錄入名片資訊。

## 名片識別技術介紹

名片識別採用OCR技術，將名片上的文字轉化識別為可進行編輯處理的相應文字，並可對識別後的名片資訊進行分類管理。它支援透過拍照識別、二維碼識別、匯入識別方式對名片資訊進行採集，使用者只需將名片放在手機拍攝的預覽框內，便可自動完成對名片識別的一系列操作，非常方便。

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

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

## 開發前準備步驟

在開始API開發工作之前，您需要完成必要的開發準備工作，同時請確保您的工程中已經配置HMS Core SDK的Maven倉地址，並且完成了本服務的SDK整合。

### 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/20201130163919104.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70)

### maven地址

```java
在buildscript->repositories裡面配置HMS SDK的maven倉地址

buildscript {
    repositories {
        maven { url 'https://developer.huawei.com/repo/' }
         
    }
}
```

在allprojects ->repositories裡面配置HMS SDK的maven倉地址

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

### 引入SDK

```java
dependencies {
    // Text recognition SDK.
    implementation 'com.huawei.hms:ml-computer-vision-ocr:2.0.1.300'
    // Text recognition model.
    implementation 'com.huawei.hms:ml-computer-vision-ocr-cn-model:2.0.1.300'
    implementation 'com.huawei.hms:ml-computer-vision-ocr-jk-model:2.0.1.300'
    implementation 'com.huawei.hms:ml-computer-vision-ocr-latin-model:2.0.1.300'
}
  
}
```

### 清單檔案

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

```

### 許可權

```java
<uses-permission android:name="android.permission.CAMERA"></uses-permission>
<uses-permission android:name="android.hardware.camera.autofocus"></uses-permission>
<uses-feature android:name="android.hardware.camera"></uses-feature>
<uses-feature android:name="android.hardware.autofocus"></uses-feature>
```

### 動態許可權申請

```java
if (!(ActivityCompat.checkSelfPermission(this, Manifest.permission.CAMERA) == PackageManager.PERMISSION_GRANTED)) {
    requestCameraPermission();
}
```

## 開發重點步驟

**1. 建立文字分析器MLTextAnalyzer用於識別圖片中的文字，使用自定義引數MLLocalTextSetting配置端側文字分析器。**

```java
MLLocalTextSetting setting = new MLLocalTextSetting.Factory()
        .setOCRMode(MLLocalTextSetting.OCR_DETECT_MODE)
        .setLanguage("zh")
        .create();
MLTextAnalyzer analyzer = MLAnalyzerFactory.getInstance()
        .getLocalTextAnalyzer(setting);
```

**2. 透過android.graphics.Bitmap建立MLFrame，支援的圖片格式包括：jpg/jpeg/png/bmp，建議輸入圖片長寬比範圍：1:2到2:1。**

```java
MLFrame frame = MLFrame.fromBitmap(bitmap);
```

**3. 將生成的MLFrame物件傳遞給“asyncAnalyseFrame”方法進行文字識別。**

```java
Task<mltext> task = analyzer.asyncAnalyseFrame(frame);
task.addOnSuccessListener(new OnSuccessListener<mltext>() {
    @Override
    public void onSuccess(MLText text) {
        // Recognition success.
         
    }
}).addOnFailureListener(new OnFailureListener() {
    @Override
    public void onFailure(Exception e) {
        // Recognition failure.
         
    }
});
```

**4. 識別完成，停止分析器，釋放識別資源。**

```java
try {
    if (analyzer != null) {
        analyzer.stop();
    }
} catch (IOException e) {
    // IOException
} catch (Exception e) {
    // Exception
}
```

## Demo效果

為了便於開發者更好的理解此場景，我們也做了一個demo app，展示名片識別的功能效果

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

如果你對實現方式感興趣，可以在Github上下載原始碼：[https://developer.huawei.com/consumer/cn/doc/HMSCore-Guides-V5/text-recognition-0000001050040053-V5#ZH-CN_TOPIC_0000001050750207__section16220018134717](https://developer.huawei.com/consumer/cn/doc/HMSCore-Guides-V5/text-recognition-0000001050040053-V5#ZH-CN_TOPIC_0000001050750207__section16220018134717)

---
原文連結：
[https://developer.huawei.com/consumer/cn/forum/topic/0204399685438720133?fid=18](https://developer.huawei.com/consumer/cn/forum/topic/0204399685438720133?fid=18)
作者：timer</mltext></mltext>

名片識別，史上最簡單的整合攻略來啦！附有SDK包

相關文章