一、准备工作

概述

本文档是人像比对SDK_iOS v1.0.0 版本的接入文档，用于指导SDK的使用方法，默认读者熟悉Xcode编译器的使用以及iOS编程语言。

前置条件

• SDK版本：V 1.0 
• Xcode版本 : V9.4.1及以上版本，iOS9.0 及以上版本。

创建应用

• 提示：一个应用对应一个appid，多个应用（不同bundleID）需在闪验平台创建多个应用以对应多个appid

应用的创建流程及APPID/APPKEY的获取，请查看「账号创建」文档

• 通过审核后 联系客服获取 SDK 使用的授权文件 xxxx.lic (需要将文件名称改为 LinkfaceID.lic) 以及授权文件的更新地址 :jsonURL;

快速体验Demo

1. 将demo 的bundle Identifer 换成自己的项目的Bundle Identifier（与平台创建项目时提交的Bundle Identifier 对应）。

2.  在demo Appdelegate.m中初始化SDK 的appkey  appid 以及jsonURL 替换为自己的  appKey appid 以及jsonURL。

3.  将demo CLLiveCheckBundle.bundle 中LinkfaceID.lic资源替换为自己的 LinkfaceID.lic 授权文件。

4.  编译运行。

开发环境搭建

1. 导入FrameWork :将实人认证SDK压缩包中framework中的所有资源添加到工程中，并选择  Copy Items if need  选项

2.  将CLLiveCheckBundle.bundle 中的LinkfaceID.lic 资源替换为自己的LinkfaceID.lic的授权文件（该授权文件与项目的Bundle Identifier绑定）。

• 找到CLLiveCheckBundle.bundle 中的LinkfaceID.lic  Show In Finder

• 将从客服获取SDK获取授权文件xxxxxx.lic（名称更改为LinkfaceID.lic）直接进行替换

3. 配置Xcode 

•  关闭Bitcode 。设置Xcode->TARGETS->Build Setitngs->EnableBitcode  为NO

• Xcode->TARGETS->Build Settings->Linking->Other Linker Flags 添加–ObjC 、-lstdc++

•  添加系统依赖库  Xcode->TARGETS->General->Linked Framworks and Libraries 添加一下了依赖库

libz.tbd

libbz2.tbd

libiconv.tbd

libz.1.2.5.tbd

VideoToolbox.framework

• Xcode->TARGETS->Info添加相机权限访问描述

二、SDK使用说明

初始化

请确保在调用人像比对服务前，调用此接口。所以我们建议在应用启动时初始化SDK.

/**
 初始化SDK
 
 @param appkey 创蓝平台APPkey
 @param appid 创蓝平台APPid
 @param jsonPathURL 授权文件更新地址
 */
+(void)initSDKWithAPPkey:(NSString * _Nonnull)appkey appid:(NSString * _Nonnull)appid jsonPath:(NSString *)jsonPathURL;

参数描述

调用示例：

#import <CLLiveCheck/CLLiveCheck.h>

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // Override point for customization after application launch.
    ...
    //初始化SDK
    [CheckSDK initSDKWithAPPkey:@"appkey" appid:@"appid" jsonPath:@"jsonURL"];
    ...
    return YES;
}

检测参数配置及调用SDK

#import "CheckLiveViewController.h"

//初始化SDK UI
    CheckLiveViewController *checkLiveViewController = [[CheckLiveViewController alloc] initUserName:@"张三" idCarNumber:@"张三的身份证号" checkLiveDuration:10];
    
    //设置活体检测 动作 传入nil 为 4个动作的随机序列
    [checkLiveViewController setDetectionSequence:@[@(BLINK),@(MOUTH),@(NOD),@(YAW)]];
    
    //设置 图片输出方式 以及 活体检测复杂度
    [checkLiveViewController setOutputType:OUTPUT_MULTI_IMAGE complexity:COMPLEXITY_NORMAL];
    
    //设置人像核验结果回调
    [checkLiveViewController setResultBlock:^(ResultType type, NSDictionary * _Nullable result, NSError * _Nullable error) {
        
    }];

  
    UINavigationController *nav = [[UINavigationController alloc] initWithRootViewController:checkLiveViewController];
    nav.navigationBar.translucent = NO;
    [self presentViewController:nav animated:YES completion:^{
        //启动检测流程
        [checkLiveViewController startLiveCheck];
    }];

参数及其含义：请参考CheckLiveViewController  类注释以及CLEnumTypy.h的定义

人证校验结果 result  示例：

{       

 "tradeNo":"633756435473235968",   

 "chargeStatus":1,

 "code":"200000",

 "message":"成功",

 "data":{

      "status":"OK",
            "identity":{
                "reason":"Gongan status OK",
                "validity":true     

      },
            "confidence":0.9357142857142857,
            "request_id":"TID3a82aa92639d4eea9f7f44c1b84872b9",

       "selfie":{
                "image_id":"09ee2fbceb8f44ad80493f2ad1955ff4"       

      }

 }

}

result字段含义：

data字段及其含义：

identity 字段及其含义

confdence 置信度阀值 及 错误率表

status 一览表