表格OCR Android SDK 簡介

概述

(1) 概念解釋

表格識(shí)別：基于深度學(xué)習(xí)技術(shù)，自動(dòng)定位并識(shí)別圖片中表格的位置、結(jié)構(gòu)及文字內(nèi)容，結(jié)構(gòu)化返回可編輯的表格結(jié)果。支持用戶上傳報(bào)表、帶有表格的圖片等。

(2) 說明

Hi，您好，歡迎使用有道智云表格識(shí)別OCR Android SDK。

如果您想快速體驗(yàn)服務(wù)，建議您前往有道智云平臺(tái) 體驗(yàn)中心 或者在體驗(yàn)中心右下側(cè)找到小程序二維碼，掃描進(jìn)行體驗(yàn)。

本文檔主要針對(duì)需要集成表格識(shí)別服務(wù)OCR Android SDK的開發(fā)工程師，詳細(xì)描述有道表格識(shí)別能力及集成過程。

如果您有與我們商務(wù)合作的需求，可以通過以下方式聯(lián)系我們：

商務(wù)郵箱： AIcloud_Business@corp.youdao.com

如果您對(duì)文檔內(nèi)容有任何疑問，可以通過以下幾種方式聯(lián)系我們：

客服QQ：1906538062

智云OCR技術(shù)交流QQ 1群: 654064748

智云OCR技術(shù)交流QQ 2群: 471638046

聯(lián)系郵箱： zhiyun@corp.youdao.com

溫馨提示：

本文檔主要針對(duì)開發(fā)人員，接入測試前需要在后臺(tái)創(chuàng)建Android應(yīng)用，并綁定實(shí)例；如果您還沒有，請(qǐng)按照 新手指南 操作。

平臺(tái)向每個(gè)賬戶贈(zèng)送50元的體驗(yàn)金，供用戶集成前測試所用，具體資費(fèi)規(guī)則詳見 表格OCR服務(wù)報(bào)價(jià) 。

功能介紹

表格識(shí)別OCR SDK是有道在線表格識(shí)別OCR 接口服務(wù)進(jìn)行封裝，支持在線表格識(shí)別。提供快速的接入方式；同時(shí)提供數(shù)據(jù)統(tǒng)計(jì)能力，方便了解用戶使用情況。

兼容性

支持設(shè)備：運(yùn)行了 Android 4.0.3以及以上系統(tǒng)的 Android 設(shè)備

表格識(shí)別OCR Android SDK集成指南

集成前提

開始集成SDK之前開發(fā)者需要登錄 有道智云平臺(tái) ，創(chuàng)建應(yīng)用獲取應(yīng)用ID（或者通過運(yùn)營人員獲取應(yīng)用ID），以便使用表格識(shí)別OCR服務(wù)。

集成步驟

(1) SDK包導(dǎo)入

請(qǐng)?jiān)诠こ涛募夸浵聞?chuàng)建一個(gè)名為 libs 的子目錄(有的話則不需要?jiǎng)?chuàng)建)，并將YoudaoBase.jar so包和YoudaoTableRecognize.jar拷貝到 libs 目錄下，并將以下代碼添加到app的build.gradle中：

android {
    sourceSets.main.jniLibs.srcDirs = ['libs']
    ...
}
dependencies {
    compile files('libs/YoudaoBase_v2.0.0.jar')
    compile files('libs/YoudaoTableRecognize_v2.0.0.jar')
}

(2) AndroidManifest配置

<uses-permission android:name="android.permission.INTERNET" />
<!-- 獲取WiFi狀態(tài) -->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<!-- 獲取網(wǎng)絡(luò)信息狀態(tài)，如當(dāng)前的網(wǎng)絡(luò)連接是否有效 -->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

<!-- 往SDCard讀寫數(shù)據(jù)權(quán)限   storage group -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

(3) 代碼混淆配置

代碼混淆文件proguard-project.txt，添加如下內(nèi)容：

-ignorewarnings
-libraryjars libs/YoudaoBase_v2.0.0.jar
-libraryjars libs/YoudaoTableRecognize_v2.0.0.jar
-keep class com.youdao.sdk.ydtranslate.** { ;} 
-keep class com.youdao.yd_table_recognize.* { *;}

(4) SDK初始化

使用之前請(qǐng)?jiān)诔绦虻腁pplication中調(diào)用SDK初始化代碼，可以參考demo中DemoApplication。 注：appkey即應(yīng)用ID。

//appkey即應(yīng)用ID。
YouDaoApplication.init(this, appkey);

功能集成

說明：請(qǐng)參考 yd_table_recognize_demo 中 TableDemoActivity 的使用

(1) 參數(shù)說明

type：上傳類型， 僅支持base64上傳（1）和文件上傳（2），請(qǐng)按需填寫

docType：服務(wù)器響應(yīng)類型，可選字段，默認(rèn)為json。目前只支持json和excel

angle：是否檢測圖片角度，可選字段，默認(rèn)檢測。0表示不檢測；1表示檢測

輸入圖片格式支持：jpg/png

輸入圖片尺寸限制：2MB以下

輸入圖片數(shù)據(jù)：需要轉(zhuǎn)換為Base64編碼。

(2) 構(gòu)造表格OCR識(shí)別參數(shù)對(duì)象

//表格OCR識(shí)別
TableRecognizeParameters tps = new TableRecognizeParameters.Builder()
                .type(TableRecognizeParameters.TYPE_BASE64)
                .build())

(3) 設(shè)置回調(diào)和開始識(shí)別

通過TableRecognize，設(shè)置上一步構(gòu)造的參數(shù)對(duì)象，調(diào)用recognize方法傳入圖片base64編碼的數(shù)據(jù)和回調(diào)接口開始查詢

識(shí)別回調(diào)接口包含兩個(gè)方法：onResult表示識(shí)別成功，結(jié)果json字符串形式給用戶，onError表示失敗，失敗信息已錯(cuò)誤碼的形式給用戶。

注意：整個(gè)識(shí)別是異步的，回調(diào)在子線程進(jìn)行，若涉及到界面操作，請(qǐng)切回主線程。

//OCR表格識(shí)別
TableRecognize.getInstance(tps)
                .recognize(base64, new TableRecognizeListener() {

                    @Override
                    public void onError(final int errorCode) {
                        handler.post(new Runnable() {
                            @Override
                            public void run() {
                                resultText.setText("識(shí)別失敗 " + TableRecognizeErrorCode.getErrorString(errorCode));
                                YouDaoLog.w("TableRecognize onError,errorCode = " + errorCode);
                            }
                        });
                    }

                    @Override
                    public void onResult(final String resultJson, final String input) {
                        handler.post(new Runnable() {
                            @Override
                            public void run() {
                                resultText.setText("識(shí)別完成");
                                YouDaoLog.w("TableRecognize onResult,result = " + resultJson + "\n" + ",input = " + input);
                                showResult(resultJson);
                            }
                        });
                    }
                });

結(jié)果說明

查詢結(jié)果以json形式給用戶格式如下所示，表格渲染可參考demo中h5表格渲染方式。

{
		"orientation": "UP",
		"tables": [{
			"boundingBox": "2106,2076,3927,2107,3912,2997,2091,2966",
			"cells": [{
				"boundingBox": "2477,2264,2602,2266,2599,2407,2474,2405",
				"rowRange": "0,0",
				"colRange": "0,0",
				"dir": "h",
				"lang": "fr",
				"lines": [{
					"boundingBox": "2477,2264,2602,2266,2599,2407,2474,2405",
					"words": [{
						"boundingBox": "2508,2264,2602,2266,2599,2407,2505,2405",
						"word": "11"
					}],
					"text": "11"
				}]
			}, {
				"boundingBox": "3352,2252,3482,2254,3480,2400,3350,2398",
				"rowRange": "0,0",
				"colRange": "1,1",
				"dir": "h",
				"lang": "en",
				"lines": [{
					"boundingBox": "3352,2252,3482,2254,3480,2400,3350,2398",
					"words": [{
						"boundingBox": "3384,2253,3482,2254,3480,2400,3382,2399",
						"word": "12"
					}],
					"text": "12"
				}]
			}, {
				"boundingBox": "2432,2700,2594,2703,2592,2849,2430,2846",
				"rowRange": "1,1",
				"colRange": "0,0",
				"dir": "h",
				"lang": "en",
				"lines": [{
					"boundingBox": "2432,2700,2594,2703,2592,2849,2430,2846",
					"words": [{
						"boundingBox": "2464,2700,2594,2703,2592,2849,2462,2846",
						"word": "21"
					}],
					"text": "21"
				}]
			}, {
				"boundingBox": "3303,2656,3641,2661,3637,2926,3299,2920",
				"rowRange": "1,1",
				"colRange": "1,1",
				"dir": "h",
				"lang": "fr",
				"lines": [{
					"boundingBox": "3303,2656,3640,2754,3637,2926,3300,2827",
					"words": [{
						"boundingBox": "3345,2668,3640,2754,3637,2926,3342,2840",
						"word": "224"
					}],
					"text": "224"
				}]
			}],
			"rowNum": "2",
			"colNum": "2"
		}],
		"regions": []
}

錯(cuò)誤代碼列表

常見問題及注意事項(xiàng)

1.運(yùn)行程序崩潰？ 檢查下是否對(duì)應(yīng)的 so 是否放到當(dāng)前工程目錄下。

2.識(shí)別沒結(jié)果？ 檢查下識(shí)別接口回調(diào)的錯(cuò)誤信息，保證申請(qǐng)的應(yīng)用ID是有效且提前綁定了。

3.如何獲得應(yīng)用ID 注冊(cè)賬號(hào)， 登錄后臺(tái)創(chuàng)建應(yīng)用和實(shí)例并完成綁定， 可獲得應(yīng)用ID和應(yīng)用密鑰等信息。

4.出現(xiàn)錯(cuò)誤HTTP_REQUEST_ERROR("Http requesterror.",1) 在確保有網(wǎng)情況下，若調(diào)用過程中出現(xiàn)這個(gè)錯(cuò)誤，HTTP_REQUEST_ERROR("Http requesterror.",1) ,請(qǐng)檢查是否是在主線程中調(diào)用的翻譯識(shí)別方法，請(qǐng)確保在主線程調(diào)用。

版本更新記錄