精品题库 IOS SDK简介

概述

(1) 概念解释

精品题库：基于文字识别技术，结合组段和渲染技术，满足用户的需求

(2) 说明

Hi，您好，欢迎使用有道智云精品题库iOS SDK。如果您想快速体验服务，建议您前往官网 精品题库体验中心 或者在体验中心页面的右下角找到小程序二维码，扫描进行体验。

本文档主要针对需要集成精品题库服务iOS SDK的开发工程师，详细描述有道智云精品题库能力及集成过程。

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

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

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

客服QQ：1906538062

智云精品题库交流QQ群：685832941

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

温馨提示：

本文档主要针对开发人员，接入测试前需要在后台创建iOS应用；如果您还没有，请按照 新手指南 操作。

平台向每个账户赠送50元的体验金，供用户集成前测试所用，具体资费规则详见 精品题库服务报价 。

功能介绍

有道精品题库SDK 是有道智云开放平台提供的云服务之一，是有道在线精品题库接口的一种实现。

兼容性

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

精品题库SDK集成指南

集成前提

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

图片支持： 格式支持：jpg/png/bmp 尺寸限制：1MB以下

集成步骤

SDK包导入

精品题库 SDK 由如下几个 SDK 组成，YDShootSearch.h、libbase.a、libShootSearch.a

(1) 添加头文件和库文件：将精品题库SDK 添加到工程中，包括 YDShootSearch.h头文件、libbase.a和libShootSearch.a文件。可以直接将SDK文件夹拖动到工程中，也可以选择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。

SDK初始化

说明：所有的查询都需要初始化key，只执行初始化一次即可。

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

功能集成

说明：请参考 demo 中 ShootSearchViewController 的使用

构造查询器

YDShootSearchRequest *request = [YDShootSearchRequest request];

将图片转化为base64编码

NSString *base64Str = [UIImageJPEGRepresentation(self.imgView.image, 1.0) base64EncodedStringWithOptions:0];

执行过程

识别返回两种情况，一种是成功，相关结果存储在 result 参数中，另外一种是失败，失败信息放在 error。详细信息可参见 错误代码列表。

[request lookup:base64Str completionHandler:^(YDShootSearchRequest *request, NSDictionary *info, NSError *error) {
    if (error) {
        //失败
        NSLog(@"error:%@", error);
        [HUDUtil show:self.view text:@"识别失败"];
    } else {
        //成功
        YDShootSearchResult *result = [YDShootSearchResult mj_objectWithKeyValues:info[@"data"]];
        NSLog(@"%@", result);
        [HUDUtil show:self.view text:@"识别成功"];
        [self showResult:result];
    }
    NSLog(@"%@", info);
}];

题库结果说明

响应结果是以json形式输出，包含字段如下表所示：

对于在线精品题库，服务器查询结果返回数据如下：

{
	"data": {
		"questions": [{
			"answer": "D.<br />根据题意画出图形.<br /><img src=\"http://nos.netease.com/yd-searchq/d2c51ea9-0ce4-4e7c-810e-df62c67cc5e3.jpg\" /><br />∵BE平分∠ABC&#xff0c;ED⊥AB&#xff0c;∠C&#61;90°&#xff0c;<br />∴DE&#61;CE.<br />∵AC&#61;AE&#43;CE&#61;6cm&#xff0c;CE&#61;DE&#xff0c;<br />∴AE&#43;DE&#61;6cm.<br />故选D.",
			"id": "922b5db8c01ab894c9ed81130e875a07",
			"analysis": "",
			"content": "在△ABC的中&#xff0c;∠C&#61;90°&#xff0c;BE平分∠ABC&#xff0c;ED⊥AB于D&#xff0c;若AC&#61;6cm&#xff0c;则AE&#43;DE&#61;()<br />A.3cm <br />B.4cm <br />C.5cm <br />D.6cm",
			"knowledge": "角平分线上的点到两边的距离相等"
		}, {
			"answer": "D",
			"id": "3f74f1b9db7fbdb9ef4f3be1e640174d",
			"analysis": "∵BE平分∠ABC&#xff0c;ED⊥AB&#xff0c;EC⊥BC∴DE&#61;CE<br />∴AE&#43;DE&#61;AE&#43;EC&#61;AC&#61;6cm.<br />故选D&#xff0e;",
			"content": "如图所示&#xff0c;在△ABC中&#xff0c;∠C&#61;90°&#xff0c;BE平分∠ABC&#xff0c;ED⊥AB于点D&#xff0c;若AC&#61;6cm&#xff0c;则AE&#43;DE&#61;( )<br/>A. 3cm<br/>B. 4cm<br/>C. 5cm<br/>D. 6cm<br /><img width=\"190\" height=\"110\" src=\"http://nos.netease.com/yd-searchq/bd8adeb1-db1a-48fd-a4ef-07897640ddb6.gif\" />",
			"knowledge": ""
		}, {
			"answer": "<p>D</p>",
			"id": "49b8fa87db38bf6004e205050eb9c548",
			"analysis": "",
			"content": "<p>如图,在 ABC中, ∠C=90°, BE平分∠ABC, ED⊥AB于点D.若AC=6cm,则AE+DE等于(    )</p><p>A3cm </p><p>B.4cm </p><p>C.5cm </p><p>D.6 cm</p><p><img src=\"http://nos.netease.com/yd-searchq/6c868298-235a-4eb6-bc3b-06ec5ecd937c.png\" title=\"1530979476605.png\" alt=\"2.png\"/></p>",
			"knowledge": ""
		}],
		"text": "如-3-9所示, ， 在 ABC中，∠C=90^ ,BE平分∠ABC,ED ABFD, ， ， 若AC=6cm,则AHE+DE= ADB -3-9"
	},
	"errorCode": "0"
}

常见问题及注意事项

1. 运行程序崩溃？

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

2. 拍搜没结果？ 检查下接口回调的错误信息，保证申请的应用ID是有效且提前绑定了。

3. 如何获得应用ID 注册账号，登录后台创建应用， 可获得应用ID和应用密钥等信息。

错误代码列表

示例图片

http://ydschool-online.nos.netease.com/15338062758120238_12000960102.jpg
http://ydschool-online.nos.netease.com/1542701989646test.png
http://ydschool-online.nos.netease.com/1542703851482WX20181120-165038%402x.png
http://ydschool-online.nos.netease.com/15427039802392.png
http://ydschool-online.nos.netease.com/154270403620010.png
http://ydschool-online.nos.netease.com/15427040781763.png
http://ydschool-online.nos.netease.com/1543828384827WechatIMG112.png

版本更新记录