全部产品
阿里云办公

iOS集成

更新时间:2018-08-06 12:49:23

操作步骤

iOS SDK 与BundleID绑定,不同BundleID需要在 管理控制台 上重新下载 SDK

下载无线认证 SDK 后,您可参考以下步骤将认证 SDK 集成到您的 iOS 应用中。

步骤一: 在工程中导入 SDK

  1. 解压无线认证 SDK 后,将以下 iOS 的依赖包引入到您的应用工程中:

    • RPSDK.framework
    • FaceLivenessOpen.framework
    • SecurityGuardSDK.framework
    • SGMain.framework
    • SGNoCaptcha.framework
    • SGSecurityBody.framework
    • AliyunOSSiOS.framework
    • WindVane.framework
    • WindVaneBasic.framework
    • WindVaneBridge.framework
    • WindVaneCore.framework
    • ZipArchive.framework
    • AliReachability.framework
  2. 确认您的工程中已引入以下实人认证服务需要的 系统依赖

    • CoreMedia.framework
    • CoreMotion.framework
    • CoreTelephony.framework
    • AVFoundation.framework
    • ImageIO.framework
    • MobileCoreServices.framework
    • MediaPlayer.framework
    • CoreLocation.framework
    • AddressBook.framework
    • AddressBookUI.framework
    • SystemConfiguration.framework
    • AudioToolbox.framework
    • AssetsLibrary.framework
    • Libresolv.tbd
    • WebKit.framework
    • Libiconv.tbd
    • Libc++.tbd
    • Libz.tbd
  3. 在您的工程资源中,引入无线认证 SDK 包中的yw_1222_*.jpg签名图片文件,以及resource目录下的FaceLivenessSDK.bundleRPSDK.bundle文件。

    bundle

  4. 编译选项

    • 在工程的Other Linker Flags选项中添加–ObjC

    • Enable Bitcode设为No

      Link

步骤二: 使用 SDK

  1. 初始化

    一般在应用启动时进行。

    1. #import <RPSDK/RPSDK.h>
    2. [RPSDK initialize:RPSDKEnvOnline] //必须为RPSDKEnvOnline
  2. 进入认证

    1. [RPSDK start:verifyToken rpCompleted:^(AUDIT auditState) {
    2. NSLog(@"verifyResult = %ld",(unsigned long)auditState);
    3. if(auditState == AUDIT_PASS) { //认证通过
    4. }
    5. else if(auditState == AUDIT_FAIL) { //认证不通过
    6. }
    7. else if(auditState == AUDIT_IN_AUDIT) { //认证中,通常不会出现,只有在认证审核系统内部出现超时,未在限定时间内返回认证结果时出现。此时提示用户系统处理中,稍后查看认证结果即可。
    8. }
    9. else if(auditState == AUDIT_NOT) { //未认证,用户取消
    10. }
    11. else if(auditState == AUDIT_EXCEPTION) { //系统异常
    12. }
    13. }withVC:self.navigationController];

    说明

    • 其中,verifyToken参数由接入方的服务端调用实人认证服务的 GetVerifyToken 接口获得。
    • 认证的结果由回调的方式返回,并携带状态。

常见问题

  1. 调起无线认证 SDK,进入认证页面展示“网络异常,请检查网络”/“UNKNOWN_ERROR”/空白。

    处理建议:查看 Xcode console,若 SG ERROR = 1208 或 1215 或 1411,说明当前开发包与在管理控制台下载 SDK 时上传包的BundleID不一致,请在管理控制台重新上传当前开发包,用新下载 SDK 中的yw_1222_*.jpg签名图片文件替换开发包中原有的文件。

  2. 项目中之前引入的组件与无线认证 SDK 中的组件有重复,例如 SecurityGuardSDK、AliyunOSSiOS 等。

    处理建议:若 SecurityGuardSDK 组件有重复,删除低版本,但保留两个版本的yw_1222_*.jpg签名图片文件;若 AliyunOSSiOS 等其他组件有重复,删除低版本即可。

  3. 项目中之前引入的 SecurityEnvSDK 组件与无线认证 SDK 中的 SGMain 组件报 duplicate symbol 冲突。

    处理建议:SecurityEnvSDK 组件是 SGMain 组件的早先版本,删除 SecurityEnvSDK,但保留两个组件的yw_1222_*.jpg签名图片文件。