有道智云 名片识别 iOS SDK 文档

有道智云 名片识别 SDK简介

概述

说明

Hi，您好，欢迎使用有道智云名片识别 iOS SDK。如果您想快速体验服务，建议您前往体验中心或者搜索小程序（有道智云体验中心）进行试用。

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

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

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

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

客服QQ：1906538062

官方交流QQ 1群：861723255

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

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

温馨提示：
本文档主要针对开发人员，接入测试前需要在后台创建iOS应用，并绑定名片识别实例；如果您还没有，请按照新手指南操作。

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

功能介绍

有道 名片识别 SDK 是基于深度学习技术，自动定位并识别名片图片中的结构及文字内容，结构化返回可编辑的名片结果。

兼容性

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

名片识别SDK集成指南

集成前提

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

集成步骤

SDK包导入

名片识别 SDK 由如下几个 SDK 组成，YDOCRStructure.h、libbase.a、libocrstructure.a

(1). 添加头文件和库文件：将 名片识别 SDK 添加到工程中，包括 YDOCRStructure.h头文件、libbase.a和libocrstructure.a文件。可以直接将OCRStructureSDK文件夹拖动到工程中，也可以选择File “Add files to ‘Project Name’…”。

(2). 设置工程Other Linker Flags为-ObjC。

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

SDK初始化

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

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

功能集成

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

构造查询器

YDOCRStructureRequest *request = [YDOCRStructureRequest request];
YDOCRStructureParam *param = [YDOCRStructureParam param];
param.structureType = @"namecard";
request.param = param;

将图片转化为base64编码

NSData *data = [self compressImage];
NSString *input = [data base64EncodedStringWithOptions:0];

执行识别过程

识别返回两种情况，一种是成功，相关结果存储在 Result 参数中，另外一种是失败，失败信息放在 error，是一个枚举类，整个识别是异步的。

[request lookup:input completionHandler:^(YDOCRStructureRequest *request, NSDictionary *result, NSError *error) {
if (error) {
NSLog(@"%@", error.localizedDescription);
} else {
[self handleResponse:result];
}
}];

识别结果说明

输出字段介绍

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

输出字段示例

{
"errorCode": "0",
"Result": {
"Name": "小李",
"Name_Eng": "Li",
"Title": "研发",
"Title_Eng": "RD",
"Depart": "智云",
"Depart_Eng": "ZHIYUN",
"Company": "有道",
"Company_Eng": "YOUDAO",
"Address": "后厂村",
"Address_Eng": "HOUCHANGCUN",
"Postcode": "100084",
"Email": "XXXX@XX.com",
"Web": "http://ai.youdao.com",
"Mobile": "136XXXXXXXX",
"Tel": "82XXXXXX",
"Fax": "82XXXXXX",
"QQ": "3XXXXXXXX",
"Wechat": "wxid_XXXXX",
"Weibo": "XXXXX",
"SNS": "XXXXX",
"Account": "XXXXX",
"Stock": "XXXXX",
"Logo": "http://ai.youdao.com/gw/logo_new.png",
"Other": "XXXXX"
}
}

图片支持

格式支持：jpg/png

尺寸限制：3MB以下

错误代码列表

常见问题及注意事项

(1). 运行程序崩溃？

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

(2). 名片识别没结果？

检查下名片识别接口回调的错误信息，保证申请的 appKey 是有效且提前绑定了。

(3). 如何获得 appKey

注册账号， 登录后台创建应用和实例并完成绑定， 可获得应用ID和密钥等信息，其中应用ID就是appKey（ 注意不是应用密钥）。

版本更新记录