SDK 版本
SDK 版本 v1.0文档版本 v1.0
修改时间 2023 年 5 月 27 日
使用授权声明
本⽂文档中所包含的信息属于商业机密信息，应严格控制使用范围。如⽆杭州学谷数据智能有限公司的书⾯许可，任何人员不得以任何方式持有或使用本⽂文档的部分或全部内容。
⽂档说明
本文所指的《学谷智能iOS 端SDK 对接文档》是针对iOS 端接口对接的详细说明⽂档。
功能描述
商户通过调⽤SDK 服务接口，实现身份证证件识别功能。
阅读对象
iOS 端开发⼈员以及相关项⽬管理⼈员。
集成准备及配置⼯作
1，请在您的工程目录结构中，将整个ShargooSDK 文件夹添加到您的项目中。
2，拖放后一般会在 ‘Build Settings - Search Paths - Framework Search Paths’中存在指向ShargooSDK 的根⽬录路径$(PROJECT_DIR)，一般情况下这个路径会自动填充，如若没有填充， 请手动填充指向存放ShargooSDK 的路径。
3，在Targets-General-Frameworks中添加Accelerate.framework
4，在Target-Build Settings-Linking-Other Linker Flags中添加-ObjC、-force_load、 ShargooTensorflow的对应路径"$(SRCROOT)/ShargooSDKDemo/ShargooSDK/ShargooTensorflow.a"
5，在Target-Build Settings中将Enable Bitcode设置为NO
6，请在info.plist ⾥添加使用相机权限和App Transport Security Settings 1)，Privacy - Camera Usage Description 2，App Transport Security Settings（添加Allow Arbitrary Loads 并设为YES）
7，引用SDK#import <Shargoo/Shargoo.h>
8，需要使用接口的页面，将.m 改为.mm
9，请使用真机进行测试开发
身份证证件识别
启动页面XGIDCardDetectionViewController
XGIDCardDetectionViewController *controller = [[XGIDCardDetectionViewController alloc] init];
// 模型下载地址
controller.downloadUrl = @"https://shargoodata.oss-cn-beijing.aliyuncs.com/model/id_card_20200907.pb?Expires=1685800309&OSSAccessKeyId=LTAIjMvEVkZaABvp&Sig nature=1eVqfuqfDJ8tVYGkO2F%2BTl2K3W4%3D";
// 用户使用协议地址（可自行配置，不填则不显示）
controller.agreementUrl = @"";
// 协议按钮字体颜色
controller.agreementColor = [UIColor redColor];
// 识别页面背景色
controller.bgColor = [UIColor grayColor];
// 进入身份证识别页面按照提示拍摄身份证正反面后
//backData 中包含所识别截取的两张身份证图片，商户可自行处理结果并处理页面 controller.idCardDetectionBlock = ^(id _Nonnull backData, UIViewController *
_Nonnull infoController) {
NSLog(@"身份证证件识别%@", backData);
// 识别后返回当前页面
// [controller.navigationController popViewControllerAnimated:YES];
// 识别后跳转某页面
// [controller.navigationController pushViewController:XXXController animated:YES];
};
[self.navigationController pushViewController:controller animated:YES];