ecologyDoc/AI/IOS接入指南.md

IOS接入指南

下载sdk包

引入cepmSdk.farmework

将cepmSdk.farmework文件夹复制到项目文件中，此framework包含最基础的实体类和通讯方法

双击项目文件，选择targets 点击 General 标签 在 Frameworks,Libraies,and Embedded Content点击加号，选择add files，选择复制进来的cepmSdk.framework

在Build Phases中，Link Binary With Libraries中加入cepmSdk.farmework

引入UI，Sdks界面文件夹

将UI和Sdks文件夹，复制到项目目录下，然后在xcode里对项目最外层点击add File to xxx，xxx为你的项目名

然后再设置里，引入以下framework包

再将Build Setting中的Other Linker Flags设置为-ObjC

再将在Build Settings中，将Validate Workspace设置为YES

最后将Build Phases中的Link Binary With Library中的cepmSdk.framework设置为Optional

人脸采集接口

Sdks/Face/BDFaceFaceSDKUI/UI/Controller中，ViewController中有如下4个方法

对比验证成功回调

- (void) verifySuccess;

对比验证失败回调

- (void) verifyFail;

活体检测完成回调（包含通讯，将自己的sysName，secret，userName填入即可）此方法仅修改里面系统参数即可及选择一个对比方法即可 里面两个方法第二个方法需要将原来的人脸信息调用FaceClient的上传方法，返回的文件服务器图片路径当参数传入

- (void) verifyComplete;

获取人脸照片保存成功的本地文件路径 - (NSString *) getFaceLocalPath;

有一个参数aiVerify，值为true代表走ai平台通讯进行后台对比，若为false则保存在本地不进行后台通讯 注意：这些方法都是在活体检测完成后点击回到首页才会触发，调用顺序为，先调用verifyComplete方法，若通讯则通讯成功调用verifySucess，失败则调用verifyFail方法，若不通讯，则图片保存到本地成功调用verifySuccess，保存失败调用verifyFail方法

OCR识别接口

Sdks/OCR/AipOcrService中

身份证正面识别

- (IdCardFrontResponse *)detectIdCardFrontFromImage:(UIImage *)image;

身份证背面识别

- (IdCardBackResponse *)detectIdCardBackFromImage:(UIImage *)image;

银行卡识别

- (BankCardResponse ) detectBankCardFromImage: (UIImage)image;

获取实例

+ (instancetype)shardService;

设置秘钥

+ (void)setCredential:(Credential *)credential;

Tts接口使用方式

获取合成的语音

DhccTtsClient.doTts方法，此方法已设置OC及Swift都可调用，参数传递TtsRequest即可

播放语音

DhccTtsClient.play方法可以播放获取到的声音，此方法已设置OC及Swift都可调用，参数传递TtsRequest即可

界面Swift App

可以直接使用UI文件夹下对应功能的文件夹中的界面，对应OcrTest，FaceTest，TtsView三个界面

界面OC Storyboard

人脸在Sdks/UI/BDFaceFaceSDKUI/UI/Controller中使用ViewController即可

OCR在/UI/OCR中直接使用Main.storyboard和OcrViewController即可

Tts只需一个文本框或无需界面，自己实现获取文本内容，调用DhccTtsClient.doTts方法即可，DhccTtsClient.play即可播放声音