• 1 iOS SDK Pro使用说明
  • 1.1 准备工作
  • 1.2 引入SDK和配置工程
  • 1.3 SDK初始化
  • 1.4 身份证OCR
  • 1.5 银行卡OCR
  • 1.6 驾驶证OCR
  • 1.7 行驶证OCR
  • 1.8 活体检测
  • 1.9 指纹识别
  • 2.0 远程身份认证（不含银行卡认证）
  • 2.1 远程身份银行卡认证（含银行卡认证）
  • 2.2 自定义UI

1 iOS Pro SDK集成说明

1.1 准备工作

• 确认已经获取AppID、AppKey、OCR License(aip.license)、活体License(idl-license.face-ios) 和 Face_Name。将aip.license和idl-license.face-ios放到CWResource.bundle资源包中。
• Face_Name的具体命名规则： appName +“-face-ios” appName为申请账户时，提交给远程实名管理平台的应用名称。

1.2 引入SDK和配置工程

• 将下面提到的framework和bundle资源添加到项目。

  1. PayEgisAuthentication.framework
  2. AipBase.framework
  3. IdcardQuality.framework
  4. IDLFaceSDK.framework
  5. PayEgisFace.framework
  6. PayegisDID.framework
  7. CWResource.bundle
  8. com.baidu.idl.face.faceSDK.bundle
  9. com.baidu.idl.face.model.bundle
  10. PayegisDID.bundle

• 在Linked Frameworks and Libraries 添加以下库

  1. libsqlite3.0.tbd
  2. PayEgisAuthentication.framework
  3. AipBase.framework
  4. IdcardQuality.framework
  5. libstdc++.tbd
  6. CoreMedia.framework
  7. AVFoundation.framework
  8. Foundation.framework
  9. IDLFaceSDK.framework
  10. PayEgisFace.framework
  11. PayegisDID.framework

• 在General-> Embeded Binaries 中添加：

  

• 修改项目配置

  Other Link flags添加-ObjC

  

  
  info.plist 配置

  1. iOS 集成需要在 info.plist 文件中添加Privacy - Camera Usage Description字段,客户根据业务需求填写相关说明。
  2. iOS 集成需要在 info.plist 文件中添加Privacy - Microphone Usage Description字段,客户根据业务需求填写相关说明。
     
  3. iOS 集成需要在 info.plist 文件中添加Privacy - Photo Library Usage Description字段,客户根据业务需求填写相关说明。
  4. iOS 集成需要在 info.plist 文件中添加Privacy - Location When In Use Usage Description字段,客户根据业务需求填写相关说明。
  5. iOS 集成需要在 info.plist 文件中添加Privacy - Motion Usage Description字段,客户根据业务需求填写相关说明。

• 在所需类中导入.h文件

1.3 SDK初始化

方法名为：

参数说明：

上下文参数说明

参考代码:

[danger] 注意

OCR扫描界面是否支持选择图库图片，通过isShowAlbum属性控制；

isHiddenAlert 标准化流程中首次使用弹出提示信息

setOCRCallBackImageType 设置OCR扫描返回结果的类型 YES 返回UIImage对象 NO 返回NSDictionary对象，包括裁剪图和原图

1.4 身份证OCR

先使用'openOCR'方法获取身份证正面和反面图像，然后调用'idOCROnly'方法，获取身份证相关信息

• 身份证OCR扫描获取图片,v3.3.0版本中新增方法，可以无需退出扫描界面直接进行下一面的扫描。可以根据需求选择调用的方法，下面是两个方法的介绍和使用。

1.OCR 扫描（身份证单面扫描）

方法名称为：

需要以下入参:

参考代码：

2.OCR 扫描（身份证自动正反面扫描）

方法名称为：

需要以下入参:

参考代码：

• 获取身份证相关信息
  

方法名称为：

需要以下入参:

参考代码：

• result相关身份信息如下：

1.5 银行卡OCR

先使用'openOCR'获取银行卡图片，然后调用'bankOCROnly'方法，获取银行卡相关信息。

• 银行卡OCR扫描获取图片 方法名称为：

需要以下入参：

参考代码：

• 获取银行卡相关信息 方法名称为：

需要以下入参：

参考代码：

• result相关银行信息如下：

1.6 驾驶证OCR

先使用'openOCR'获取驾驶证图片，然后调用'drivingOCROnly'方法，获取驾驶证相关信息。

• 驾驶证OCR扫描获取图片 方法名称为：

需要以下入参：

参考代码：

• 获取驾驶证相关信息 方法名称为：

需要以下入参：

参考代码：

• result相关驾驶证信息如下：

1.7 行驶证OCR

先使用'openOCR'获取行驶证图片，然后调用' vehicleOCROnly'方法，获取行驶证相关信息。

• 行驶证OCR扫描获取图片 方法名称为：

需要以下入参：

参考代码：

• 获取行驶证相关信息 方法名称为：

需要以下入参：

参考代码：

• result相关行驶证信息如下：

1.8 活体检测

活体检测分为两个接口： startLivenessAction: completion:、startLivenessAction: randomBool：completion:

• 传入随机数目[1~6]，做相应数目的随机动作。

方法名称为：

需要以下入参：

参考代码：

• 传入动作数组，决定是否随机执行活体检测动作。

方法名称为：

需要以下入参：

参考代码：

1.9 指纹识别

  SDK Pro中封装了系统指纹识别,使用了PKI(Public Key Infrastructure)技术来保证指纹识别信息传输的机密性和完整性。

方法名称为：

参数说明：

错误码说明：

参考代码：

2.0 远程身份认证（不含银行卡认证）

方法名称为：

参数说明：

参考代码：

2.1 远程身份银行卡认证（含银行卡认证）

  远程身份银行卡认证分为三要素认证和四要素认证，两者区别是四要素认证会校验手机号。三要素和四要素认证通过txntype参数来获取不同的事务号。

参数说明：

方法名称为：

参数说明：

参考代码：

2.2 自定义UI

远程实名认证SDK(V3.3.0以上)提供了以下方法来进行UI的自定义，具体介绍如下

2.2.1 自定义导航条（UINavigationBar）

通过调用- (void) setNavagatinStyleBlock:(PENavigatonVCStyleBlock) block方法可以设置导航栏的文字颜色、字体大小、背景图片和返回按钮的设置。通过setBarTintColor方法来设置导航栏的颜色无效。

方法名称为：

参考代码：

2.2.2 自定义按钮

通过调用- (void) setCustomButton:(NSDictionary *) dictinoary;方法可以设置部分按钮的文字颜色和背景颜色。

方法名称为：

参数说明：

参考代码：

2.2.3 自定义活体检测页面

通过PayEgisFace.framework的PayegisFaceSDK.h提供的- (void) setFaceLivessTheme:(NSDictionary *) dictionary;方法可以设置活体检测页面文字颜色、圆圈颜色、倒计时边框颜色和文字颜色。

• 下图设置活体检测页面相关文字提示、圆圈、倒计时圆圈和倒计时文字的颜色。

• 下图设置活体检测页面关闭按钮、警告提示、成功提示、背景的图片。

  

方法名称为：

参数说明：

参考代码：