1. 文档说明

2. 版本说明

2.1 版本升级改动点说明：

• 去除『人形虚线检测框』、改成圆形进度条显示进度、采集提示文案一级、二级文案字体、颜色调整
• 采集框新增倒计时功能提示，默认20秒阈值，全流程整数倒计时
• 新增中英文文案切换，语言类型非简体中文ZH_CN时，禁用所有采集提示音。默认简体中文ZH_CN，SDK初始化前支持传入英文标识EN来修改配置。
• 部分页面icon图片尺寸和文字字体大小调整
• 外国人永居证件号新规则兼容 在已有15位老证件号校验规则的同时，新增支持18位新证件号的规则校验，同时满足以下条件的证件号，允许透传至权威库进行核验： （1）总位数为18，仅存在数字或"X" （2）首位数字固定为“9”，为外国人标识码 （3）最后一位为校验位，与通过前17位计算得来的结果匹配（同二代身份证校验位计算）
• ocr鉴权首次下载失败问题优化修复

3. SDK说明

4. 运行项目工程

4.1 打开下载的iOS示例工程

如下图所示：

4.2 使用如下链接请求百度Token

https://aip.baidubce.com/oauth/2.0/token?grant_type=client_credentials&client_id=【百度云应用的AK】&client_secret=【百度云应用的SK】 注意：上述百度云应用的AK和百度云应用的SK，应当替换为您自己名下的AK和SK。 详细获取资料，请参考：https://ai.baidu.com/ai-doc/REFERENCE/Ck3dwjhhu 最终获取到的token应如下图所示：

4.3 全局搜索关键词： #warning developer

注意：这种方式只是调试阶段的代码，上线代码不可用如下方式，而应该每次都重写获取，因为token会在一定时间内变化）可以找到如下，被注释的代码 /// self.accessToken = @"";如下图所示

【重要】这里这种写法仅仅用于测试功能，正式上线，token不能写成固定值，需要每次都请求。为了安全期间，建议将请求放到自己服务器上，做一层转发，而不是将AK，SK写在端上来请求。

打开这个注释，将上述token内容写入：例： self.accessToken = @"25.b55fe1d287227ca97aab219bb249b8ab.315360000.1798284651.282335-8574074"； 代码如下图所示：

4.4 确认bundleId等信息是否正确

连接真机进行运行，之后可以看到如下界面：

4.5 点击开始身份认证

测试示例工程是否跑通，之后扫码身份证或输入身份证信息后，点击进行身份核验，验证成功可以看到如下界面：

上图为示例工程运行成功，之后可以将示例工程代码集成到目标项目中。

5. 集成步骤

5.1 将BDFaceSDK文件夹下所有文件拖动到目标项目中

如下图所示

5.2 将AipBase.framework, AipOcrSdk.framework和IdcardQuality.framework DebugFramework.framework拖动到目标项目

如下所图示

5.3 将BDFaceSDK文件夹（如下图所示的文件夹）整体拖入到目标代码中；

5.4 在Build Phases中点击下面的+号

选择NewCopyFilePhases,添加一个CopyFiles（可重新命名为Embed）

5.5 双击CopyFiles

改为Embed Frameworks，同时Destination改为framework，之后将AipBase.framework、AipOcrSdk.framework和IdcardQuality.framework 拖动到下面

5.6 Link Binary With Libraries中添加libc++.tbd、libz.tbd 和 对应的framework

如下图所示:

5.7 确认添加的库文件设置正确

如下图所示，点击general, 这三个库需要为Do Not Embed：BDFaceBaseKit.framework, BDFaceLogicLayer.framework，CoreTelephony.framework.

5.8 info.plist 文件中添加以下key（获取相机和照片权限）

最后之后可以将人脸核验示例工程代码代码结合自身工程项目，将相关代码集成到目标工程中。

6. 授权文件、加密文件

人脸识别授权文件（idl-license.face-ios），图片加密文件（idl-key.face-ios），OCR身份证识别授权文件（aip.license），从console平台下载完iOS项目，这些文件即包括在下载的示例项目中，不需要特殊处理，按上面第5.3步整体拖入目标项目中即可。

6.1 鉴权文件配置相关问题说明:

配置授权信息： 导入license文件后，需配置FACE_LICENSE_NAME、FACE_LICENSE_ID等信息:

具体参数使用请参照示例demo。

license文件使用注意事项：如出现鉴权失败无法调用人脸采集，请检查license id与license文件导入及配置是否正常。

（1）license id需要注意-face-ios后缀是否添加。

（2）如存在多种环境配置，请确保每个环境下的license id与license文件一一对应。tip：license文件存在运行缓存，切换测试环境请清空缓存，删除安装包后重新编译安装。

（3）确保license文件路径访问正常。

（4）如出现网络鉴权失败等提示，说明license文件与FACE_LICENSE_NAME未正确设置，请才考接入demo检查工程环境，确保参数无误。

加解密key文件使用注意事项：根据2.1-2.2步骤添加加解密key文件到项目工程

（1）确保加解密key文件已重命名为idl-key.face-ios。

（2）确保idl-key.face-ios文件路径访问正常。

（3）若存在多中环境配置，请手动更新该对应文件，清空缓存后重新编译安装app包进行测试。

7. 人脸相关接口

7.1 设置默认参数（动作活体参数，人脸配置参数，UI参数）

初始化人脸和OCR SDK */

• (void)initFaceServiceAndInfoCollectService

初始化人脸SDK动作活体参数配置 */

• (void)initFaceSDK

7.2 初始化接口

初始化接口调用 用于初始化人脸识别和OCR识别

入参说明

initFaceBlock中，使用以下函数进行人脸SDK初始化 -(void)initCollectWithLicenseID:(NSString )licenseID andLocalLicenceName:(NSString )licenseName andExtradata:(NSDictionary *)extradata callback:(FaceSDKInitResultBlock )block;

回调状态码说明

具体枚举值如下

7.2 人脸实名认证接口（有源）

基于姓名、身份证号、当前SDK获取的人脸图片，与权威库进行对比，并得出比对分数，并基于此进行业务判断是否为同一人。
此处最终采集到的数据经过加密处理，需要配合开放平台人脸实名认证V4接口使用，包含活体检测、质量检测、实名认证功能，可通过传入参数进行控制，如您的业务场景核心为实名认证，无需重复请求7.3活体检测接口（startFaceLiveness）。

注：如果配置APP方案时，身份信息录入的方式选择【业务调用时传入身份信息】，那么通过APP服务端接口获取姓名和证件号后，将获取到的姓名和证件号赋值给name和idcard_number字段即可。

入参dic (NSDictionary类型) key值列表如下：

回调说明

resultDic key值列表说明：

resultCode和resultMsg对应情况如下：

7.3 活体检测接口

包含本地活体加云端活体，本地活体分静默活体、炫瞳活体、动作活体三种，云端活体可以判断图片中的人脸是否为二次翻拍以及是否为合成图攻击。
此处最终采集到的数据经过加密处理，需要配合开放平台在线图片活体V4接口使用，实现二次验证采集图片是否存在假体攻击破绽的情况。
如您的业务场景核心为人脸实名认证，请直接请求7.2 实名认证接口。

入参dic (NSDictionary类型) key值列表如下：

回调说明

callback key值列表说明：

7.4 人脸采集及人脸比对接口（无源）

包含本地质量和本地活体，本地质量可以确保采集到的人脸图像符合各条件校验（满足姿态角、光照、模糊度、遮挡等校验），本地活体分静默活体、炫瞳活体、动作活体三种。
此处最终采集到的数据经过加密处理，需要配合开放平台人脸对比V4接口使用，包含活体检测、质量检测、人脸1:1识别功能，可通过传入参数进行控制，如您的业务场景核心为实名认证，无需重复请求7.3活体检测接口（startFaceLiveness）。

回调说明

resultDic key值列表说明：

7.5 人脸相关配置

人脸相关配置来自于百度云控制台下发的console_config.json文件，详细参考BDConfigFileParser类，不设置，将使用默认值。

8. OCR身份证识别相关接口

8.1 OCR身份证识别初始化接口

入参说明

注：如果aip.license文件鉴权文件正确，那么可以使用OCR识别成功识别身份证信息。

8.2 OCR身份证识别接口

支持对二代居民身份证字段进行结构化识别，包括姓名、性别，调用参考OCR身份证识别接口文档。

参数值列表如下：

config配置说明

9. 权限

10. 只使用人脸采集功能，不使用OCR

10.1 运行示例工程代码

点击开始身份核验，走完所有流程，可以出现如下界面：

10.2 删除库文件：AipOcrSdk.framework，AipBase.framework，IdcardQuality.framework

10.3 全局搜索与AipOcrSDK/AipOcrSdk.h

找到后并删除项目中所有引入对应SDK的代码，也可以注释，在删除后可能导致编译不通过，可以根据报错部分保证正常功能不受影响的同时进行相应的代码注释。

10.4 全局搜索 -(void) startOCRSdk 并注释该函数

注意：其他编译报错部分调用的地方也需要注释或删除

  // 打开相机扫描
     - (void)startOCRSdk {
    [self configCallback];
    // 身份证识别
    [AipCaptureCardVC clearIdCard];
    BDAipOCRConfig *config = [[BDAipOCRConfig alloc] init];
    AipNavigationController *detectNavi = [AipCaptureCardVC viewControllerToDetectIdCard:config
                                                 handler:^(UIImage *image) {
        _idCardImage = image;
        [[AipOcrService shardService] detectIdCardFrontFromImage:image
                                                     withOptions:nil
                                                  successHandler:^(id result) {
            _successHandler(result);
        } failHandler:_failHandler];
    }];
    UIViewController *detectRoot = [[UIViewController alloc] init];
    detectRoot.view.backgroundColor = [UIColor whiteColor];
    detectRoot.view.clipsToBounds = YES;
    [detectRoot addChildViewController:detectNavi];
    [detectRoot.view addSubview:detectNavi.view];

    [self.navigationController pushViewController:detectRoot animated:YES];

    _vc = detectRoot;
    __weak typeof(detectRoot) weakDetectRoot = detectRoot;
    detectNavi.captureController.backAction = ^{
        [weakDetectRoot.navigationController popViewControllerAnimated:YES];
    };}

10.5 .编译运行代码首页并将身份证OCR功能关闭或者使用代码

   // 身份证获取方式   1 OCR扫描    0  手动输入  2代码传
    + (int)useOCR {
    BDConfigDataService *service = [self sharedInstance];
    NSNumber *value = service.sharedDic[BDConfigDataServiceKeyForSettingOcr];
    if (value) {
        return value.intValue;
    }
    return [[BDConfigFileParser sharedInstance] useOCR];}

10.6 将userOCR的值设置为0

保证程序只能手动输入身份信息来调用人脸，此部分功能模块不使用也可以对应删除。

运行工程