(1) 概念解釋
整題識別(含公式)服務:基于有道機器學習團隊業(yè)界領先的深度學習技術,將自然場景下圖片上的題目文字、數字及公式信息,通過定位和檢測,智能識別為可編輯的文本信息,輕松實現題目電子化。
(2) 說明
Hi,您好,歡迎使用有道智云整題識別(含公式) iOS SDK。
如果您想快速體驗服務,建議您前往 體驗中心 或者在體驗中心右下側找到小程序二維碼,掃描進行體驗。
本文檔主要針對需要集成整題識別(含公式)服務iOS SDK的開發(fā)工程師,詳細描述有道智云整題識別(含公式)能力及集成過程。
如果您有與我們商務合作的需求,可以通過以下方式聯系我們:
商務郵箱: AIcloud_Business@corp.youdao.com
如果您對文檔內容有任何疑問,可以通過以下幾種方式聯系我們:
客服QQ:1906538062
智云OCR技術交流QQ 1群: 654064748
智云OCR技術交流QQ 2群: 471638046
聯系郵箱: zhiyun@corp.youdao.com
溫馨提示:
本文檔主要針對開發(fā)人員,接入測試前需要在后臺創(chuàng)建iOS應用,并綁定整題識別(含公式)實例;如果您還沒有,請按照 新手指南 操作。
平臺向每個賬戶贈送50元的體驗金,供用戶集成前測試所用,具體資費規(guī)則詳見 整題識別服務報價 。
有道整題識別(含公式) SDK 是有道智云開放平臺提供的云服務之一,是有道在線整題識別(含公式) 接口的一種實現,支持在線整題識別(含公式)。
支持設備:運行了iOS 9.0及以上系統(tǒng)的 iOS 設備
開始集成SDK之前開發(fā)者需要登錄 有道智云平臺 ,創(chuàng)建應用獲取應用ID(或者通過運營人員獲取應用ID),以便使用公式服務。
1.SDK包導入
整題識別(含公式) SDK 由如下幾個 SDK 組成,FanYiSDK.h、libbase.a、libFormula.a
(1). 添加頭文件和庫文件:將FormulaSDK 添加到工程中,包括 FanYiSDK.h頭文件、libbase.a和libFormula.a文件??梢灾苯訉ormulaSDK文件夾拖動到工程中,也可以選擇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.將圖片轉化為base64編碼
NSString *base64Str = [self image2DataURL:self.imgView.image];
3.執(zhí)行識別過程
識別返回兩種情況,一種是成功,相關結果存儲在 result
參數中,另外一種是失敗,失敗信息放在 error
,是一個枚舉類,整個識別是異步的。
[request lookup:base64Str WithCompletionHandler:^(YDFormulaRequest *request, NSDictionary *result, NSError *error) {
if (error) {
//失敗
NSLog(@"error:%@", error);
}else {
//成功
[self handleFormulaReuslt:result];
}
}];
對于在線整題識別(含公式),服務器查詢結果返回數據如下:
{
"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 數據解析封裝為 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
語言 | 代碼 |
---|---|
中文 | zh-CHS |
日文 | ja |
英文 | EN |
韓文 | ko |
法文 | fr |
俄文 | ru |
葡萄牙文 | pt |
西班牙文 | es |
錯誤碼 | 含義 |
---|---|
101 | 缺少必填的參數 |
102 | 不支持的語言類型 |
103 | 翻譯文本過長 |
104 | 不支持的API類型 |
105 | 不支持的簽名類型 |
106 | 不支持的響應類型 |
107 | 不支持的傳輸加密類型 |
108 | 應用ID無效,注冊賬號,登錄后臺創(chuàng)建應用和實例并完成綁定,可獲得應用ID和應用密鑰等信息 |
109 | batchLog格式不正確 |
110 | 無相關服務的有效實例 |
111 | 開發(fā)者賬號無效 |
113 | q不能為空 |
114 | 不支持的圖片傳輸方式 |
201 | 解密失敗,可能為DES,BASE64,URLDecode的錯誤 |
202 | 簽名檢驗失敗 |
203 | 訪問IP地址不在可訪問IP列表 |
205 | 請求的接口與應用的平臺類型不一致,如有疑問請參考入門指南 |
206 | 因為時間戳無效導致簽名校驗失敗 |
207 | 重放請求 |
301 | 辭典查詢失敗 |
302 | 翻譯查詢失敗 |
303 | 服務端的其它異常 |
304 | 會話閑置太久超時 |
401 | 賬戶已經欠費停 |
402 | offlinesdk不可用 |
411 | 訪問頻率受限,請稍后訪問 |
412 | 長請求過于頻繁,請稍后訪問 |
1001 | 無效的OCR類型 |
1002 | 不支持的OCR image類型 |
1003 | 不支持的OCR Language類型 |
1004 | 識別圖片過大 |
1201 | 圖片base64解密失敗 |
1301 | OCR段落識別失敗 |
1411 | 訪問頻率受限 |
1412 | 超過最大識別字節(jié)數 |
2003 | 不支持的語音聲道 |
2004 | 不支持的語音上傳類型 |
2005 | 不支持的語言類型 |
2006 | 不支持的識別類型 |
2201 | 識別音頻文件過大 |
2301 | 識別音頻時長過長 |
2411 | 不支持的音頻文件類型 |
2412 | 不支持的發(fā)音類型 |
3001 | 不支持的語音格式 |
3002 | 不支持的語音采樣率 |
3003 | 不支持的語音聲道 |
3004 | 不支持的語音上傳類型 |
3005 | 不支持的語言類型 |
3006 | 不支持的識別類型 |
3007 | 識別音頻文件過大 |
3008 | 識別音頻時長過長 |
3009 | 不支持的音頻文件類型 |
3010 | 不支持的發(fā)音類型 |
3201 | 解密失敗 |
3301 | 語音識別失敗 |
3302 | 語音翻譯失敗 |
3303 | 服務的異常 |
3411 | 訪問頻率受限,請稍后訪問 |
3412 | 超過最大請求字符數 |
5001 | 無效的OCR類型 |
5002 | 不支持的OCR image類型 |
5003 | 不支持的語言類型 |
5004 | 識別圖片過大 |
5005 | 不支持的圖片類型 |
5006 | 文件為空 |
5201 | 解密錯誤,圖片base64解密失敗 |
5301 | OCR段落識別失敗 |
5411 | 訪問頻率受限 |
5412 | 超過最大識別流量 |
9001 | 不支持的語音格式 |
9002 | 不支持的語音采樣率 |
9003 | 不支持的語音聲道 |
9004 | 不支持的語音上傳類型 |
9005 | 不支持的語音識別 Language類型 |
9301 | ASR識別失敗 |
9303 | 服務器內部錯誤 |
9411 | 訪問頻率受限(超過最大調用次數) |
9412 | 超過最大處理語音長度 |
10001 | 無效的OCR類型 |
10002 | 不支持的OCR image類型 |
10004 | 識別圖片過大 |
10201 | 圖片base64解密失敗 |
10301 | OCR段落識別失敗 |
10411 | 訪問頻率受限 |
10412 | 超過最大識別流量 |
13001 | 不支持的角度類型 |
13002 | 不支持的文件類型 |
13003 | 表格識別圖片過大 |
13004 | 文件為空 |
13301 | 表格識別失敗 |
17001 | 需要圖片 |
17002 | 圖片過大(1M) |
17003 | 識別類型未找到 |
17004 | 不支持的識別類型 |
17005 | 服務調用失敗 |
-1000 | 未知錯誤 |
-2000 | 查詢輸入為空 |
1.運行程序崩潰?
檢查下是否對應的 SDK靜態(tài)庫包
是否放到當前工程目錄下。
2.整題識別(含公式)沒結果?
檢查下整題識別(含公式)接口回調的錯誤信息,保證申請的應用ID是有效且提前綁定了。
3.如何獲得應用ID
注冊賬號,登錄后臺創(chuàng)建應用和實例并完成綁定, 可獲得應用ID和應用密鑰等信息。
上線日期 | 版本號 | 更新內容 |
---|---|---|
2019.05.28 | v1.0.0 | 有道智云整題識別(含公式) iOS SDK上線 |