有道智云 整题识别（含公式） SDK简介

概述

(1) 概念解释

整题识别（含公式）服务：基于有道机器学习团队业界领先的深度学习技术，将自然场景下图片上的题目文字、数字及公式信息，通过定位和检测，智能识别为可编辑的文本信息，轻松实现题目电子化。

(2) 说明

Hi，您好，欢迎使用有道智云整题识别（含公式） iOS SDK。

如果您想快速体验服务，建议您前往 体验中心 或者在体验中心右下侧找到小程序二维码，扫描进行体验。

本文档主要针对需要集成整题识别（含公式）服务iOS SDK的开发工程师，详细描述有道智云整题识别（含公式）能力及集成过程。

如果您有与我们商务合作的需求，可以通过以下方式联系我们：

商务邮箱： AIcloud_Business@corp.youdao.com

如果您对文档内容有任何疑问，可以通过以下几种方式联系我们：

客服QQ：1906538062

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

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

联系邮箱： zhiyun@corp.youdao.com

温馨提示：
本文档主要针对开发人员，接入测试前需要在后台创建iOS应用，并绑定整题识别（含公式）实例；如果您还没有，请按照 新手指南 操作。
平台向每个账户赠送50元的体验金，供用户集成前测试所用，具体资费规则详见 整题识别服务报价 。

功能介绍

有道整题识别（含公式） SDK 是有道智云开放平台提供的云服务之一，是有道在线整题识别（含公式） 接口的一种实现，支持在线整题识别（含公式）。

兼容性

支持设备：运行了iOS 9.0及以上系统的 iOS 设备

整题识别（含公式）SDK集成指南

集成前提

开始集成SDK之前开发者需要登录 有道智云平台 ，创建应用获取应用ID（或者通过运营人员获取应用ID），以便使用公式服务。

集成步骤

1.SDK包导入

整题识别（含公式） SDK 由如下几个 SDK 组成，FanYiSDK.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，只执行初始化一次即可。

//初始化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.执行识别过程

识别返回两种情况，一种是成功，相关结果存储在 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"
    }
}

服务器是按照区域，行，字的格式返回的，即一张图片会识别出图片对应的 Result，其上可能有多个区域 Region，每个区域会包含一行或多行 Line，每行又包括一个或多个字 Word，每个区域、行或者字符，都会通过 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

支持语言

错误代码列表

常见问题及注意事项

1.运行程序崩溃？

检查下是否对应的 SDK静态库包 是否放到当前工程目录下。

2.整题识别（含公式）没结果？

检查下整题识别（含公式）接口回调的错误信息，保证申请的应用ID是有效且提前绑定了。

3.如何获得应用ID

注册账号，登录后台创建应用和实例并完成绑定， 可获得应用ID和应用密钥等信息。

版本更新记录