# IOS接入指南
[下载sdk包](http://dmgl.donghuajinyun.com/cepm/ecologyDoc/src/branch/master/AI/demo/ios_sdk.zip)

## 引入cepmSdk.farmework

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

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

![image-20210122162135571](https://tva1.sinaimg.cn/large/008eGmZEly1gmzsdx2otnj31gb0u0gr5.jpg)

![image-20210122162239159](https://tva1.sinaimg.cn/large/008eGmZEly1gmzsemh56mj30u00uq49c.jpg)

![image-20210122162321663](https://tva1.sinaimg.cn/large/008eGmZEly1gmzseu9wovj31co0r87d8.jpg)

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

![image-20210125105515756](https://tva1.sinaimg.cn/large/008eGmZEly1gmzseyi0b0j31fv0u0q9b.jpg)



## 引入UI，Sdks界面文件夹

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

![image-20210125103719891](https://tva1.sinaimg.cn/large/008eGmZEly1gmzsf2rbp5j30tk0x2qag.jpg)

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

![image-20210125105206483](https://tva1.sinaimg.cn/large/008eGmZEly1gmzsf5zuldj31ga0u0tem.jpg)

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

![image-20210125105317171](https://tva1.sinaimg.cn/large/008eGmZEly1gmzsfc814vj31cu0u0qau.jpg)

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

![image-20210125105642191](https://tva1.sinaimg.cn/large/008eGmZEly1gmzsf9c8w8j31dl0u0dnq.jpg)
最后将Build Phases中的Link Binary With Library中的cepmSdk.framework设置为Optional
![image-20210328000000001](https://tva1.sinaimg.cn/large/008eGmZEly1gozzhpemqhj31wi0pkt9q.jpg)

## 人脸采集接口

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

对比验证成功回调

\- (**void**) verifySuccess;

对比验证失败回调

\- (**void**) verifyFail;

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

\- (**void**) verifyComplete;
![image-1](https://tva1.sinaimg.cn/large/008eGmZEly1gozzw9wgrxj31ek0jogmx.jpg)

获取人脸照片保存成功的本地文件路径

\- (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即可播放声音