有道智云 整題識別（含公式） SDK簡介

概述

(1) 概念解釋

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

(2) 說明

Hi，您好，歡迎使用有道智云整題識別（含公式） iOS SDK。

如果您想快速體驗服務，建議您前往 體驗中心 或者在體驗中心右下側(cè)找到小程序二維碼，掃描進行體驗。

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

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

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

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

客服QQ：1906538062

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

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

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

溫馨提示： 本文檔主要針對開發(fā)人員，接入測試前需要在后臺創(chuàng)建iOS應用，并綁定整題識別（含公式）實例；如果您還沒有，請按照 新手指南 操作。 平臺向每個賬戶贈送50元的體驗金，供用戶集成前測試所用，具體資費規(guī)則詳見 整題識別服務報價 。

功能介紹

有道整題識別（含公式） SDK 是有道智云開放平臺提供的云服務之一，是有道在線整題識別（含公式） 接口的一種實現(xiàn)，支持在線整題識別（含公式）。

兼容性

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

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

集成前提

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

集成步驟

1.SDK包導入

整題識別（含公式） SDK 由如下幾個 SDK 組成，F(xiàn)anYiSDK.h、libbase.a、libFormula.a

(1). 添加頭文件和庫文件：將FormulaSDK 添加到工程中，包括 FanYiSDK.h頭文件、libbase.a和libFormula.a文件。可以直接將FormulaSDK文件夾拖動到工程中，也可以選擇File “Add files to ‘Project Name’…”

(2). 設置工程Other Linker Flags為-ObjC

(3). 在工程build Phases – Link Binary With Libraries中添加libbase.a, AdSupport.framework, CoreTelephony.framework, SystemConfiguration, libz.tbd和libsqlite3.tbd。

2.SDK初始化

說明：所有的查詢都需要初始化key，只執(zhí)行初始化一次即可。

//初始化key
YDTranslateInstance *yd = [YDTranslateInstance sharedInstance];
yd.appKey = @"your appkey";

功能集成

說明：請參考 demo 中 FormulaOnlineController 的使用

1.構造查詢器

YDFormulaRequest *request = [YDFormulaRequest request];
YDFormulaParameter *param = [YDFormulaParameter param];
param.source = @"youdaoformula"; //設置源
param.detectType = @"10011"; //設置識別類型
request.param = param;

2.將圖片轉(zhuǎn)化為base64編碼

NSString *base64Str = [self image2DataURL:self.imgView.image];

3.執(zhí)行識別過程

識別返回兩種情況，一種是成功，相關結(jié)果存儲在 result 參數(shù)中，另外一種是失敗，失敗信息放在 error，是一個枚舉類，整個識別是異步的。

[request lookup:base64Str WithCompletionHandler:^(YDFormulaRequest *request, NSDictionary *result, NSError *error) {
    if (error) {
        //失敗
        NSLog(@"error:%@", error);
    }else {
        //成功
        [self handleFormulaReuslt:result];
    }
}];

識別結(jié)果說明

對于在線整題識別（含公式），服務器查詢結(jié)果返回數(shù)據(jù)如下：

{
    "errorCode": "0",
    "Result": {
    "orientation": "",
        "regions": [{
        "boundingBox": "13,16,584,16,584,82,13,82",
        "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,16,326,16,326,82,111,82",
                "text_height": 66,
                "words": [{
                "boundingBox": "111,16,326,16,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,23,338,76,327,75",
                "word": "，"
                }, {
                "boundingBox": "350,23,384,23,384,76,350,76",
                "word": "則"
                }],
                "text": "，則",
                "type": "text"
            }, {
                "boundingBox": "385,16,584,16,584,82,385,82",
                "text_height": 66,
                "words": [{
                "boundingBox": "385,16,584,16,584,82,385,82",
                "word": " \\sqrt { - x - 1 } ="
                }],
                "text": "\\sqrt { - x - 1 } =",
                "type": "formula"
            }]
        ]
        }],
    "exif": "UP"
    }
}

服務器是按照區(qū)域，行，字的格式返回的，即一張圖片會識別出圖片對應的 Result，其上可能有多個區(qū)域 Region，每個區(qū)域會包含一行或多行 Line，每行又包括一個或多個字 Word，每個區(qū)域、行或者字符，都會通過 boundingBox 字段返回坐標和大小。 SDK 對上述 json 數(shù)據(jù)解析封裝為 YDFormulaResult 對象，如下：

@interface YDFormulaResult : NSObject
@property (nonatomic, copy) NSString *orientation;
@property (nonatomic, copy) NSString *angle;
@property (nonatomic, copy) NSString *exif;
@property (nonatomic, strong) NSArray *regions;
+ (instancetype)initWithDict:(NSDictionary *)info;
@end


@interface YDFormulaRegion : NSObject
@property (nonatomic, copy) NSString *boundingBox;
@property (nonatomic, copy) NSString *dir;
@property (nonatomic, strong) NSArray *lines;
+ (instancetype)initWithDict:(NSDictionary *)info;
@end

@interface YDFormulaElement : NSObject
@property (nonatomic, copy) NSString *boundingBox;
@property (nonatomic, copy) NSString *text;
@property (nonatomic, copy) NSString *type;
+ (instancetype)initWithDict:(NSDictionary *)info;
@end

支持語言

錯誤代碼列表

常見問題及注意事項

1.運行程序崩潰？

檢查下是否對應的 SDK靜態(tài)庫包 是否放到當前工程目錄下。

2.整題識別（含公式）沒結(jié)果？

檢查下整題識別（含公式）接口回調(diào)的錯誤信息，保證申請的應用ID是有效且提前綁定了。

3.如何獲得應用ID

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

版本更新記錄