整題識(shí)別（含公式）Android SDK簡(jiǎn)介

概述

(1) 概念解釋

整題識(shí)別（含公式）服務(wù)：基于有道機(jī)器學(xué)習(xí)團(tuán)隊(duì)業(yè)界領(lǐng)先的深度學(xué)習(xí)技術(shù)，將自然場(chǎng)景下圖片上的題目文字、數(shù)字及公式信息，通過(guò)定位和檢測(cè)，智能識(shí)別為可編輯的文本信息，輕松實(shí)現(xiàn)題目電子化。

(2) 說(shuō)明

Hi，您好，歡迎使用有道智云整題識(shí)別（含公式） Android SDK。如果您想快速體驗(yàn)服務(wù)，建議您前往 體驗(yàn)中心 或者在體驗(yàn)中心右下側(cè)找到小程序二維碼，掃描進(jìn)行體驗(yàn)。

本文檔主要針對(duì)需要集成整題識(shí)別（含公式） Android SDK的開(kāi)發(fā)工程師，詳細(xì)描述有道整題識(shí)別能力及集成過(guò)程。

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

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

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

客服QQ：1906538062

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

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

智云語(yǔ)音技術(shù)交流QQ群：861723255

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

溫馨提示：

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

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

功能介紹

整題識(shí)別（含公式）Android SDK是有道整題識(shí)別（含公式）服務(wù)進(jìn)行封裝，支持在題目識(shí)別。提供快速的接入方式；同時(shí)提供數(shù)據(jù)統(tǒng)計(jì)能力，方便了解用戶(hù)使用情況。

兼容性

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

整題識(shí)別（含公式）Android SDK集成指南

集成前提

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

集成步驟

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

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

android {
    sourceSets.main.jniLibs.srcDirs = ['libs']
    ...
}
dependencies {
    compile files('libs/YoudaoBase_v2.0.0.jar')
    compile files('libs/YoudaoLatexRecognize_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讀寫(xiě)數(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/YoudaoLatexRecognize_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);

功能集成

說(shuō)明：請(qǐng)參考 yd_latex_demo 中 LatexDemoActivity 的使用

(1) 參數(shù)說(shuō)明

detectType：識(shí)別類(lèi)型，10011:識(shí)別結(jié)果公式完美還原；10012：識(shí)別結(jié)果適合搜題，默認(rèn)為10011

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

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

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

(2) 構(gòu)造整題識(shí)別SDK參數(shù)對(duì)象

//識(shí)別對(duì)象
LatexParameters tps = new LatexParameters.Builder().source("youdaolatex").timeout(100000)
                .detectType(LatexConstants.DETECT_TYPE).build();

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

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

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

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

//開(kāi)始識(shí)別
ImageLatexRecognizer.getInstance(tps).recognize(base64Data, new LatexListener() {
            @Override
            public void onError(final LatexErrorCode error) {
                runOnUiThread(new Runnable() {
                    @Override
                    public void run() {
                        // TODO Auto-generated method stub
                        resultText.setText("識(shí)別失敗" + error.name());
                    }
                });
            }

            @Override
            public void onResult(final LatexResult result, String input) {
                //若有更新界面操作，請(qǐng)切換到主線程
                runOnUiThread(new Runnable() {
                    @Override
                    public void run() {
                        YouDaoLog.d("latex end");
                        mResultView.setVisibility(View.VISIBLE);
                        mResultView.setText(getResult(result));
                        resultText.setText("識(shí)別完成");
                    }
                });
            }
        });

整題識(shí)別結(jié)果說(shuō)明

其中LatexResult是對(duì)json結(jié)果的封裝。result中json字段如下所示:

{
    "errorCode": "0",
    "Result": {
        "orientation": "",
        "regions": [{
            "boundingBox": "13,15,584,15,584,83,13,83",
            "dir": "h",
            "lang": "",
            "lines": [
                [{
                    "boundingBox": "13,22,110,22,110,76,13,76",
                    "text_height": 53,
                    "words": [{
                        "boundingBox": "13,23,74,22,74,75,13,76",
                        "word": "13."
                    }, {
                        "boundingBox": "86,22,110,22,110,75,86,75",
                        "word": "若"
                    }],
                    "text": "13.若",
                    "type": "text"
                }, {
                    "boundingBox": "111,15,326,15,326,82,111,82",
                    "text_height": 67,
                    "words": [{
                        "boundingBox": "111,15,326,15,326,82,111,82",
                        "word": " x = ( \\sqrt { 3 } { - 5 } ) ^ { 3 }"
                    }],
                    "text": "x = ( \\sqrt { 3 } { - 5 } ) ^ { 3 }",
                    "type": "formula"
                }, {
                    "boundingBox": "327,22,384,22,384,76,327,76",
                    "text_height": 53,
                    "words": [{
                        "boundingBox": "327,22,338,22,338,75,327,75",
                        "word": "，"
                    }, {
                        "boundingBox": "350,23,384,23,384,76,350,76",
                        "word": "則"
                    }],
                    "text": "，則",
                    "type": "text"
                }, {
                    "boundingBox": "385,15,584,15,584,83,385,83",
                    "text_height": 67,
                    "words": [{
                        "boundingBox": "385,16,584,15,584,82,385,83",
                        "word": " \\sqrt { - x - 1 } ="
                    }],
                    "text": "\\sqrt { - x - 1 } =",
                    "type": "formula"
                }]
            ]
        }],
        "exif": "UP"
    }
}

錯(cuò)誤代碼列表

常見(jiàn)問(wèn)題及注意事項(xiàng)

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

2.識(shí)別沒(méi)結(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)用過(guò)程中出現(xiàn)這個(gè)錯(cuò)誤，HTTP_REQUEST_ERROR("Http requesterror.",1) ,請(qǐng)檢查是否是在主線程中調(diào)用的翻譯識(shí)別方法，請(qǐng)確保在主線程調(diào)用。

版本更新記錄