# 前言
問卷調查收集是最常見的社會調查的一種方法， 通常應於市場調查，資訊收集等方面。但是龐大的問卷調查收集完了之後面對如此大量的資料該怎麼錄入，並將內容轉換為電子文件呢？今天就為大家介紹透過整合華為HMS ML Kit表格識別服務來輕鬆實現表格錄入功能。

# 應用場景
華為HMS ML Kit表格識別服務是利用AI技術從輸入的圖片中識別並返回表格結構資訊（包括單元格的行列資訊和座標資訊）和表格中的文字資訊（包括單元格內的文字內容），支援識別中英文文字資訊及標點符號。表格識別服務在日常工作場景中有廣泛應用。例如，收集到大量紙質表格問卷後，可以透過該服務將識別到的問卷內容轉換為電子文件，減少人工錄入成本，大幅提高工作效率。

## 注意事項
- 支援識別具有表格特徵的表單、問卷等。
- 暫時不支援圖片中含有多張表格的識別，不支援獲取表頭及表尾資訊。
- 滿足以下條件可達到最佳識別效果（如下示圖）：

# 開發步驟
## 1.     開發準備
詳細的準備步驟可以參考華為開發者聯盟：
[https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides-V5/dev-process-0000001050038076-V5?ha_source=hms1](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides-V5/dev-process-0000001050038076-V5?ha_source=hms1)

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

### 1.1 專案級gradle裡配置Maven倉地址

```java
buildscript {
    repositories {
        google()
        jcenter()
        maven {url 'https://developer.huawei.com/repo/'}
    }
    dependencies {
        ...
        classpath 'com.huawei.agconnect:agcp:1.4.1.300'
    }
}
 
allprojects {
    repositories {
        google()
        jcenter()
        maven {url 'https://developer.huawei.com/repo/'}
    }
}
```

### 1.2 檔案頭增加配置
整合SDK後，在檔案頭新增配置

```java
apply plugin: 'com.android.application'
apply plugin: 'com.huawei.agconnect'
```

### 1.3 應用級gradle裡配置SDK依賴

```java
dependencies{
    // 引入基礎SDK
    implementation 'com.huawei.hms:ml-computer-vision-formrecognition:2.0.4.300'
    // 引入表格識別模型包
    implementation 'com.huawei.hms:ml-computer-vision-formrecognition-model:2.0.4.300'
}
```

### 1.4 將以下語句新增到AndroidManifest.xml檔案中，用於自動更新機器學習模型

```java
 <meta-data android:name="com.huawei.hms.ml.DEPENDENCY" android:value="fr"></meta-data>
```

### 1.5 申請攝像頭許可權
```java
<uses-permission android:name="android.permission.CAMERA"></uses-permission>
<uses-feature android:name="android.hardware.camera"></uses-feature>
```

## 2.     程式碼開發
### 2.1建立表格識別分析器。

```java
MLFormRecognitionAnalyzerSetting setting = new MLFormRecognitionAnalyzerSetting.Factory().create();
MLFormRecognitionAnalyzer analyzer = MLFormRecognitionAnalyzerFactory.getInstance().getFormRecognitionAnalyzer(setting);
```

### 2.2透過android.graphics.Bitmap建立MLFrame物件用於分析器識別表格，支援的圖片格式包括：jpg/jpeg/png，建議圖片尺寸不小於960*960畫素，不大於1920*1920畫素。

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

### 2.3呼叫asyncAnalyseFrame非同步方法或analyseFrame同步方法進行表格識別（JsonObject物件的資料結構定義請參見JsonObject）。

```java
// asyncAnalyseFrame非同步呼叫。
Task<jsonobject> recognizeTask = analyzer.asyncAnalyseFrame(mlFrame);
recognizeTask.addOnSuccessListener(new OnSuccessListener<jsonobject>() {
    @Override
    public void onSuccess(JsonObject recognizeResult) {
        // 識別成功。
    }
}).addOnFailureListener(new OnFailureListener() {
    @Override
    public void onFailure(Exception e) {
        // 識別失敗。
    }
});
 
// analyseFrame同步呼叫。
SparseArray<jsonobject> recognizeResult = analyzer.analyseFrame(mlFrame);
if (recognizeResult != null && recognizeResult.get(0).get("retCode").getAsInt() == MLFormRecognitionConstant.SUCCESS) {
    // 識別成功。
} else {
    // 識別失敗。
}
```

### 2.4檢測完成，停止分析器，釋放檢測資源。

```java
if (analyzer != null) {
    analyzer.stop();
}
```

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

# 總結
華為機器學習表格識別服務為開發者提供識別圖片中表格的服務，可廣泛應用於問卷調查資料收集等應用場景中，代替人工錄入，減少成本。

欲瞭解更多詳情，請參閱：

華為開發者聯盟官網：[https://developer.huawei.com/consumer/cn/hms?ha_source=hms1](https://developer.huawei.com/consumer/cn/hms?ha_source=hms1)

獲取開發指導文件：[https://developer.huawei.com/consumer/cn/doc/development?ha_source=hms1](https://developer.huawei.com/consumer/cn/doc/development?ha_source=hms1)

參與開發者討論請到Reddit社群：[https://www.reddit.com/r/HMSCore/](https://www.reddit.com/r/HMSCore/)

下載demo和示例程式碼請到Github：[https://github.com/HMS-Core](https://github.com/HMS-Core)

解決整合問題請到Stack Overflow：[https://stackoverflow.com/questions/tagged/huawei-mobile-services?tab=Newest](https://stackoverflow.com/questions/tagged/huawei-mobile-services?tab=Newest)

**如您有任何疑問或需要幫助，請與我們聯絡：mlkit@huawei.com**

---
原文連結：[https://developer.huawei.com/consumer/cn/forum/topic/0204429136296960028?fid=18](https://developer.huawei.com/consumer/cn/forum/topic/0204429136296960028?fid=18)

原作者：timer</jsonobject></jsonobject></jsonobject>

一文輕鬆整合華為HMS ML Kit 表格識別服務

相關文章