整題識別（含公式）Android SDK簡介

概述

(1) 概念解釋

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

(2) 說明

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

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

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

商務郵箱： AIcloud_Business@corp.youdao.com

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

客服QQ：1906538062

智云OCR技術交流QQ 1群: 654064748

智云OCR技術交流QQ 2群: 471638046

智云語音技術交流QQ群：861723255

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

溫馨提示：

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

平臺向每個賬戶贈送50元的體驗金，供用戶集成前測試所用，具體資費規(guī)則詳見 整題識別OCR服務報價 。

功能介紹

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

兼容性

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

整題識別（含公式）Android SDK集成指南

集成前提

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

集成步驟

(1) SDK包導入

請在工程文件根目錄下創(chuàng)建一個名為 libs 的子目錄(有的話則不需要創(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)絡信息狀態(tài)，如當前的網(wǎng)絡連接是否有效 -->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

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

(3) 代碼混淆配置

代碼混淆文件proguard-project.txt，添加如下內容：

-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初始化

使用之前請在程序的Application中調用SDK初始化代碼，可以參考demo中DemoApplication。
注：appkey即應用ID。

//appkey即應用ID
YouDaoApplication.init(this, appkey);

功能集成

說明：請參考 yd_latex_demo 中 LatexDemoActivity 的使用

(1) 參數(shù)說明

detectType：識別類型，10011:識別結果公式完美還原；10012：識別結果適合搜題，默認為10011

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

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

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

(2) 構造整題識別SDK參數(shù)對象

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

(3) 設置回調和開始識別

通過ImageLatexRecognizer，設置上一步構造的參數(shù)對象，調用recognize方法傳入圖片base64編碼的數(shù)據(jù)和回調接口開始查詢

識別回調接口包含兩個方法：onResult表示識別成功，結果LatexResult對象形式給用戶，onError表示失敗，失敗信息已錯誤碼的形式給用戶。

注意：整個識別是異步的，回調在子線程進行，若涉及到界面操作，請切回主線程。

//開始識別
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("識別失敗" + error.name());
                    }
                });
            }

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

整題識別結果說明

其中LatexResult是對json結果的封裝。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"
    }
}

錯誤代碼列表

常見問題及注意事項

1.運行程序崩潰？
檢查下是否對應的 so 是否放到當前工程目錄下。

2.識別沒結果？
檢查下識別接口回調的錯誤信息，保證申請的應用ID是有效且提前綁定了。

3.如何獲得應用ID
注冊賬號， 登錄后臺創(chuàng)建應用和實例并完成綁定， 可獲得應用ID和應用密鑰等信息。

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

版本更新記錄