IOS

更新时间：2021-12-28

1、简介

1.1 功能介绍

百度安全增强级采集 SDK iOS 版是一种面向 iOS 移动设备的人脸技术开发包，此版SDK包含人脸检测、活体识别等功能。基于该方案，开发者可以轻松的构建包含人脸检测、采集和活体识别的应用。在您使用SDK之前，我们首先为您介绍以下SDK本身及相关人脸能力，以便您能更方便使用人脸服务。

此版SDK基于在线的安全能力封装为人脸比对和实名认证两个核心流程，主要用于在客户端执行这两种流程。因为这两种流程最终需要向服务器发起请求以完成认证，因此无法在离线环境下使用。

此版SDK所包含的能力如下：

动作活体检测：通过让用户做出指定人脸配合式的交互动作，识别当前操作者是否为活体，此功能为离线使用，可设定指定动作是否使用及应用顺序。动作包含：眨眼、张嘴、左摇头，右摇头，向上抬头，向下低头六个。可有效抵御高清图片、3D建模、视频等攻击。
人脸质量检测：判断视频流中的图片帧中，哪些图片质量较佳，即人脸图像特征清晰（满足遮挡、姿态、光照、模糊度等校验）。
人脸图像采集：通过本地SDK能力，采集人脸图像，同时经过人脸质量检测，确保采集到的人脸图像符合各条件校验（遮挡、姿态、光照、模糊度等），为设备前端获取有效可分析人脸的主要功能。
授权：SDK的授权判断，授权介质也称为license，在SDK使用中，需要通过license向授权服务器发起请求，判断SDK的使用合法性及使用有效期。
人脸比对和实名认证流程：通过将原子操作封装为安全的流程，在流程中加入多种安全防护能力，能够抵御大多数针对人脸流程的攻击。因为不用自行维护流程，应用程序使用人脸比对和实名认证功能也变得更加简便。

为了方便您的开发，我们已经为您准备了多种场景的示例工程，您可以根据业务需要，在后台进行直接下载，目前支持【人脸核身】【人脸闸机/门禁】【人脸登录/考勤】【多人脸识别】,示例工程参考下图：

1.2 兼容性

系统：支持iOS9以上系统。需要开发者通过Deployment Target 来保证支持系统的检测。
机型：手机和平板皆可（暂不支持横屏）
架构：arm64、armv7
网络：支持 WIFI 及移动网络,移动网络支持使用 NET 网关及WAP 网关(CMWAP、CTWAP、UNIWAP、3GWAP)。

1.3 开发包说明

文件/文件夹名	说明
FaceSDK	FaceSDK 包、bundle 资源文件、bundle 模型文件、鉴权文件
Public/Common	视频流处理类
Public/Utils	图像处理类
UI/Controller	DEMO工程
UI/View	View控制类
FaceParameterConfig.h	配置信息

2、集成指南

2.1 准备工作

2.1.1 申请license

人脸SDK License：此license用于SDK离线功能使用，在您的申请人脸SDK的后台页面，全局->产品服务->人脸识别->客户端SDK申请

人脸控制台路径如下：

点击客户端SDK管理，弹出如下图：创建应用（这里创建应用是为了使用离线SDK，上面创建应用为了使用人脸在线接口，如注册、识别等）

在弹出的框中输入授权标识，选择应用类型，应用系统，以及包名，详情请查看输入框右边提示

2.1.2 下载SDK

下载SDK分为自动配置授权信息（创建license后就可以选择为该应用，下载后SDK自动帮您配置授权，不用下载license拷贝到工程中，初始化参数licenseID,包名也帮您配置好了）和未配置授权信息两种方式：

2.2 运行示例工程

2.2.1 自动配置授权信息集成

如果您是通过自动配置授权信息下载的示例工程，只需配置好证书即可。查看下项目中的FaceParameterConfig.h文件，已经自动配置

配置好证书，即可运行。注意已经设置好的bundle id不要随意改动。

2.2.2 未使用自动配置授权信息的集成

手动导入授权信息。需要手动导入license文件，配置好bundleID、licenseID等信息:

2.3 添加SDK到工程

1、打开或者新建一个项目。

2、右键点击项目，会出现一个添加菜单，在菜单中选择『Add Files to“此处是你的项目名字”…… 』,如下图所示：

3、在添加文件弹出框里面选择申请到的license和SDK添加进来。如下图：

注意：license为百度官方提供的。

BDFaceSDK文件夹下包含下面文件:

com.baidu.idl.face.faceSDK.bundle
com.baidu.idl.face.live.action.image.bundle
com.baidu.idl.face.model.faceSDK.bundle
idl-key.face-ios
idl-license.face-ios
FaceSSDKLib（libFaceSSDKLib.a、SSDKLib.h、SSFaceDetectionManager.h、SSFaceSDK.h、SSFaceSDKManager.h）

4、确认下Bundle Identifier 是否是申请license时填报的那一个，注意：license和Bundle Identifier是一一对应关系，填错了会导致SDK不能用。

5、填写正确的FACE_LICENSE_ID。

（即后台展示的LicenseID）

在FaceParameterConfig.h文件里面填写拼接好的FACE_LICENSE_ID。

6、选择链接C++标准库。

7、如果没有使用pod管理第三方库的话，请在Build Setting >Linking > Other Linker Flags 上面加入 –ObjC 选项。如果用了pod请忽略，因为pod会自动添加上。

2.4 权限声明

需要使用相机权限：编辑Info.plist文件，添加

Privacy- Camera Usage Description 的Key值，Value为使用相机时候的提示语，可以填写：『使用相机』。

3、接口说明

3.1 FaceSDK 鉴权初始化

3.1.1 设置鉴权功能

Objective-c

1- (void)setLicenseID:(NSString *)licenseID andLocalLicenceFile:(NSString *)licensePath andRemoteAuthorize:(BOOL)remoteAuthorize;

参数：

licenseId : 平台申请的 licenseID
localLicencePath : 鉴权文件路径
remoteAuthorize：是否开启网络鉴权

返回：

参考AppDelegate.m 实现，使用方法如下：

Objective-c

1    NSString* licensePath = [[NSBundle mainBundle] pathForResource:FACE_LICENSE_NAME ofType:FACE_LICENSE_SUFFIX];
2    NSAssert([[NSFileManager defaultManager] fileExistsAtPath:licensePath], @"license文件路径不对，请仔细查看文档");
3    [[SSFaceSDKManager sharedInstance] setLicenseID:FACE_LICENSE_ID andLocalLicenceFile:licensePath andRemoteAuthorize:true];

3.1.2 鉴权成功的凭证

Objective-c

1- (BOOL)canWork

参数：

返回：

True代表成功，false代表失败

参考ViewController.m 实现，判断鉴权是否通过：

Objective-c

1if (![[FaceSDKManager sharedInstance] canWork]){
2   NSLog(@"授权失败，请检测ID 和 授权文件是否可用");
3   return;
4}

3.2 FaceSDK 功能初始化

3.2.1 SSFaceSDKManager参数配置

具体方法详见如下：

Objective-c

1/**
2 * 获取版本号
3 */
4- (NSString *)getVersion;
5
6/**
7 *  重置计数器
8 */
9- (void)reset;
10
11/**
12 * 获取设备zid 公安验证上传
13 */
14- (NSString *)getZtoken;
15
16/**
17 *  SDK鉴权方法-文件授权
18 *  SDK鉴权方法 必须在使用其他方法之前设置，否则会导致SDK不可用
19 *
20 *  @param licenseID 授权ID
21 *  @param licensePath 本地鉴权文件路径
22 *  @param remoteAuthorize 是否远程更新过期鉴权文件
23 */
24- (void)setLicenseID:(NSString *)licenseID andLocalLicenceFile:(NSString *)licensePath andRemoteAuthorize:(BOOL)remoteAuthorize;
25
26/**
27 *  SDK云端校验设置
28 *  需要云端校验，需提前申请id和secret
29 *
30 *  @param clientId api key
31 *  @param clientSecret api secret
32 */
33- (void)setBCEClientId:(NSString *)clientId clientSecret:(NSString *)clientSecret;
34
35/**
36 *  初始化采集功能
37 */
38- (int) initCollect;
39
40/**
41 *  卸载采集功能
42 */
43- (int)uninitCollect;
44
45/**
46 *  判断授权是否通过，true 表示通过，false 表示不通过
47 */
48- (BOOL)canWork;
49
50/**
51 *  设置预测库耗能模式
52 *  默认 LITE_POWER_NO_BIND
53 */
54- (void)setLitePower:(int)litePower;
55
56/**
57 *  需要检测的最大人脸数目
58 *  默认1
59 */
60- (void)setMaxDetectNum:(int)detectNum ;
61
62/**
63 *  需要检测的最小人脸大小
64 *  默认40
65 */
66- (void)setMinFaceSize:(int)width;
67
68/**
69 *  人脸置信度阈值（检测分值大于该阈值认为是人脸
70 *  RGB
71 *  默认 0.5f
72 */
73- (void)setNotFaceThreshold:(CGFloat)thr ;
74
75/**
76 *  质量检测遮挡阈值
77 *  默认0.5
78 */
79- (void)setOccluThreshold:(CGFloat)thr ;
80
81/**
82 * 质量检测遮挡阈值-左眼遮挡置信度
83 * 默认0.31
84 */
85-(void)setOccluLeftEyeThreshold:(CGFloat)thr ;
86
87/**
88 * 质量检测遮挡阈值- 右眼遮挡置信度
89 * 默认0.31
90 */
91-(void)setOccluRightEyeThreshold:(CGFloat)thr ;
92
93/**
94 * 质量检测遮挡阈值-鼻子遮挡置信度
95 * 默认0.27
96 */
97-(void)setOccluNoseThreshold:(CGFloat)thr ;
98
99/**
100 * 质量检测遮挡阈值-嘴巴遮挡置信度
101 * 默认0.2
102 */
103-(void)setOccluMouthThreshold:(CGFloat)thr ;
104
105/**
106 * 质量检测遮挡阈值-左脸遮挡置信度
107 * 默认0.48
108 */
109-(void)setOccluLeftCheekThreshold:(CGFloat)thr ;
110
111/**
112 * 质量检测遮挡阈值-右脸遮挡置信度
113 * 默认0.48
114 */
115-(void)setOccluRightCheekThreshold:(CGFloat)thr ;
116
117/**
118 * 质量检测遮挡阈值-下巴遮挡置信度
119 * 默认0.4
120 */
121-(void)setOccluChinThreshold:(CGFloat)thr ;
122
123
124/**
125 * 最大光照阈值
126 */
127- (void)setMaxIllumThreshold:(CGFloat)thr;
128
129/**
130 * 最小光照阈值
131 */
132- (void)setMinIllumThreshold:(CGFloat)thr ;
133
134/**
135 *  质量检测模糊阈值
136 *  默认0.5
137 */
138- (void)setBlurThreshold:(CGFloat)thr ;
139
140/**
141 *  姿态检测阈值
142 *  默认pitch=12，yaw=12，row=10
143 */
144- (void)setEulurAngleThrPitch:(float)pitch yaw:(float)yaw roll:(float)roll ;
145
146/**
147 * 输出图像个数
148 * 默认3
149 */
150- (void)setMaxCropImageNum:(int)imageNum ;
151
152/**
153 * 输出图像宽，设置为有效值(大于0)则对图像进行缩放，否则输出原图抠图结果
154 * 默认 480
155 */
156- (void)setCropFaceSizeWidth:(CGFloat)width ;
157
158/**
159 * 输出图像高，设置为有效值(大于0)则对图像进行缩放，否则输出原图抠图结果
160 * 默认 680
161 */
162- (void)setCropFaceSizeHeight:(CGFloat)height ;
163
164/**
165 * 输出图像，下巴扩展，大于等于0，0：不进行扩展
166 * 默认0.1
167 */
168- (void)setCropChinExtend:(CGFloat)chinExtend ;
169
170/**
171 * 输出图像，额头扩展，大于等于0，0：不进行扩展
172 * 默认0.2
173 */
174- (void)setCropForeheadExtend:(CGFloat)foreheadExtend ;
175
176/**
177 * 输出图像，人脸框与背景比例，大于等于1，1：不进行扩展
178 * 默认1.5f
179 */
180- (void)setCropEnlargeRatio:(float)cropEnlargeRatio;
181
182/**
183 * 动作超时配置
184 */
185- (void)setConditionTimeout:(CGFloat)timeout ;
186
187/**
188 * 语音间隔提醒配置
189 */
190- (void)setIntervalOfVoiceRemind:(CGFloat)timeout;
191
192/**
193 * 是否开启口罩检测，非动作活体检测模型true，动作活体检测模型false
194 */
195- (void)setIsCheckMouthMask:(BOOL)isCheck;
196
197/**
198 * 口罩检测阈值配置，默认0.8。
199 * 大于阈值判定为戴口罩，低于阈值判定为未戴口罩
200 */
201- (void)setMouthMaskThreshold:(CGFloat)thr ;
202
203/**
204 * 设置原始图片缩放比例，默认1不缩放，scale 阈值0~1
205 */
206- (void)setImageWithScale:(CGFloat)scale;
207
208/**
209 * 设置图片加密类型，type=0 基于base64 加密；type=1 基于百度安全算法加密
210 */
211- (void)setImageEncrypteWithType:(int) type;
212
213/**
214 *  人脸过远框比例 默认：0.4
215 */
216- (void)setMinRect:(float) minRectScale;
217/**
218 * 采集动作验证
219 * @param image 检测的图片
220 * @param isOriginal 是否返回原始图片
221 * @param completion 判断采集是否完成，人脸信息状态是否正常
222 */
223- (void)detectWithImage:(UIImage *)image isRreturnOriginalValue:(BOOL) isOriginal completion:(void (^)(FaceInfo *faceinfo, ResultCode resultCode))completion;
224
225/**
226 * 动作活体动作验证
227 * @param image 检测的图片
228 * @param actionLiveType 当前要求做的动作
229 * @param completion 判断当前动作是否完成，人脸信息状态是否正常
230 */
231- (void)livenessWithImage:(UIImage *)image withAction:(FaceLivenessActionType)actionLiveType completion:(void (^)(FaceInfo *faceinfo, FaceLivenessState *state, ResultCode resultCode))completion;
232
233/**
234 * 设置活体动作
235 * @param array 包含活体动作种类
236 * @param order 是否顺序执行
237 * @param numberOfLiveness 活体数量
238 */
239- (void)livenesswithList:(NSArray *)array order:(BOOL)order numberOfLiveness:(NSInteger)numberOfLiveness;
240
241/**
242 * 活体检测过程中，返回活体总数，当前成功个数，当前活体类型
243 */
244-(void)livenessProcessHandler:(LivenessProcess)processHandler;

3.2.2 FaceSDK 初始化

Objective-c

1- (int)initCollect;

参数:

返回：

参考ViewController.m initSDK 方法实现：

Objective-c

1- (void) initSDK {
2     if (![[SSFaceSDKManager sharedInstance] canWork]){
3        NSLog(@"授权失败，请检测ID 和 授权文件是否可用");
4        return;
5    }
6    
7    // 初始化SDK配置参数，可使用默认配置
8    // 设置最小检测人脸阈值
9    [[SSFaceSDKManager sharedInstance] setMinFaceSize:200];
10    // 设置截取人脸图片高
11    [[SSFaceSDKManager sharedInstance] setCropFaceSizeWidth:480];
12    // 设置截取人脸图片宽
13    [[SSFaceSDKManager sharedInstance] setCropFaceSizeHeight:640];
14    // 设置人脸遮挡阈值
15    [[SSFaceSDKManager sharedInstance] setOccluThreshold:0.5];
16    // 设置亮度阈值
17    [[SSFaceSDKManager sharedInstance] setMinIllumThreshold:40];
18    [[SSFaceSDKManager sharedInstance] setMaxIllumThreshold:240];
19    // 设置图像模糊阈值
20    [[SSFaceSDKManager sharedInstance] setBlurThreshold:0.3];
21    // 设置头部姿态角度
22    [[SSFaceSDKManager sharedInstance] setEulurAngleThrPitch:10 yaw:10 roll:10];
23    // 设置人脸检测精度阈值
24    [[SSFaceSDKManager sharedInstance] setNotFaceThreshold:0.6];
25    // 设置抠图的缩放倍数
26    [[SSFaceSDKManager sharedInstance] setCropEnlargeRatio:2.5];
27    // 设置照片采集张数
28    [[SSFaceSDKManager sharedInstance] setMaxCropImageNum:3];
29    // 设置超时时间
30    [[SSFaceSDKManager sharedInstance] setConditionTimeout:15];
31    // 设置开启口罩检测，非动作活体检测可以采集戴口罩图片
32    [[SSFaceSDKManager sharedInstance] setIsCheckMouthMask:true];
33    // 设置开启口罩检测情况下，非动作活体检测口罩过滤阈值，默认0.8 不需要修改
34    [[SSFaceSDKManager sharedInstance] setMouthMaskThreshold:0.8f];
35    // 设置原始图缩放比例
36    [[SSFaceSDKManager sharedInstance] setImageWithScale:0.8f];
37    // 初始化SDK功能函数
38    [[SSFaceSDKManager sharedInstance] initCollect];
39    // 设置人脸过远框比例
40    [[SSFaceSDKManager sharedInstance] setMinRect:0.4];
41    
42    /// 设置用户设置的配置参数
43    [BDFaceAdjustParamsTool setDefaultConfig];
44}

3.2.3 FaceSDK 释放

Objective-c

1- (int)uninitCollect

参数:

返回：

3.3 人脸采集和活体识别

人脸采集和活体识别由SSFaceDetectionManager类实现，类结构如下：

Objective-c

1/**
2 * 流程返回结果类型
3 */
4typedef NS_ENUM(NSInteger, BDFaceCompletionStatus) {
5    BDFaceCompletionStatusSuccess = 1,  // 成功
6    BDFaceCompletionStatusNoRisk = 2,   // 无风险
7    BDFaceCompletionStatusImagesSuccess = 3, // 图像采集成功
8    
9    BDFaceCompletionStatusIsRunning = -1,   // 正在采集图像
10    BDFaceCompletionStatusResultFail = -2,  // 云端服务执行失败
11    BDFaceCompletionStatusIsRiskDevice = -3,    // 风险设备
12    BDFaceCompletionStatusCameraError = -5,    // 没有授权镜头
13    BDFaceCompletionStatusTimeout = -6, // 超时
14    BDFaceCompletionStatusCancel = -7, // 取消
15    BDFaceCompletionStatusSDKNotInit = -13, // SDK未初始化
16    BDFaceCompletionStatusLicenseFail = -15, // 授权错误
17    BDFaceCompletionStatusNetworkError = -16,    // 网络错误
18};
19
20@protocol SSCaptureDataOutputProtocol <NSObject>
21
22// 帧图像回传，用于刷新UI使用
23- (void)captureOutputSampleBuffer:(UIImage *)image;
24
25// 本次人脸流程回调
26- (void)faceSessionCompletionWithStatus:(BDFaceCompletionStatus)status result:(NSDictionary *)result;
27
28// 活体检测状态
29- (void)livenessActionDidFinishWithCode:(LivenessRemindCode)code;
30
31// 人脸识别检测
32- (void)detectionActionDidFinishWithCode:(DetectRemindCode)code;
33
34@end
35@interface SSFaceDetectionManager : NSObject
36
37// 图像返回帧处理代理
38@property (nonatomic, weak) id<SSCaptureDataOutputProtocol> delegate;
39
40// 采集流程运行状态
41@property (nonatomic, assign, readonly) BOOL runningStatus;
42
43// 风险检测超时时间，默认3秒
44@property (nonatomic, assign) NSInteger riskDetectionSetting;
45
46// AVCaptureSessionPreset类型枚举，支持低版本所以使用NSString
47@property (nonatomic, copy) NSString *sessionPresent;
48
49// 采集图像区域
50@property (nonatomic, assign) CGRect previewRect;
51
52// 探测区域
53@property (nonatomic, assign) CGRect detectRect;
54
55// 是否开启声音提醒
56@property (nonatomic, assign) BOOL enableSound;
57
58// 返回图片类型
59@property (nonatomic, assign) BDFaceOutputImageType outputImageType;
60
61
62+ (instancetype)sharedInstance;
63
64- (void)connectPreviewLayer:(AVCaptureVideoPreviewLayer*)pLayer;
65/**
66 * 创建用于实名认证的参数
67 */
68- (NSDictionary *)creatFaceVerifyParameters:(NSString *)idCardNumber
69                                       name:(NSString *)name
70                                 verifyType:(FaceIdCardType)cardType
71                                     nation:(NSString *)nation
72                                phoneNumber:(NSString *)phoneNumber
73                            livenessControl:(FaceLivenessControlType)livenessControl
74                            spoofingControl:(FaceSpoofingControlType)spoofingControl
75                             qualityControl:(FaceQualityControlType)qualityControl;
76
77/**
78 * 创建用于人脸比对的参数
79 */
80- (NSDictionary *)createFaceMatchParametersWithRegisterImage:(NSString *)registerImageBase64
81                                           registerImageType:(FaceRegisterImageType)registerImageType
82                                            registerFaceType:(FaceFaceType)registerFaceType
83                                                    faceType:(FaceFaceType)faceType
84                                                faceSortType:(FaceSortype)faceSortType
85                                                 phoneNumber:(NSString *)phoneNumber
86                                             livenessControl:(FaceLivenessControlType)livenessControl
87                                              qualityControl:(FaceQualityControlType)qualityControl
88                                     registerLivenessControl:(FaceLivenessControlType)registerLivenessControl
89                                      registerQualityControl:(FaceQualityControlType)registerQualityControl;
90
91
92/**
93 * 开始当前人脸校验流程
94 * @param detectionType 业务流程，采集信息用于实名认证、人脸比对
95 * @param parameters 流程需要的参数
96 * @param flowType 操作流程，人脸采集、人脸活体
97 * @param vc 用于进行人脸信息采集的ViewController
98 */
99- (void)startSessionWithType:(BDFaceResultReportType)detectionType parameters:(NSDictionary *)parameters faceFlow:(BDFaceFlowType)flowType viewController:(UIViewController *)vc;
100
101/**
102 * 取消当前人脸校验流程
103 */
104- (void)cancel;
105
106@end

3.3.1 流程介绍

整体流程如下：

通过createFaceVerify/Match 两个方法，创建用于进行人脸识别和人脸比对的参数
调用startSessionWithType方法启动人脸流程
SSCaptureDataOutputProtocol代理的方法会收到回调，来通知具体步骤和结果
最终在faceSessionCompletionWithStatus回调方法中通知人脸过程成功或失败

具体过程参数和结果中的枚举，请参考.h头文件中的注释，及Demo中的代码。

3.3.2 参数介绍

previewRect与detctRect是为了做距离检测而定义的，为了在上层封装判断脸是否在框内／离太远／离太近。

delegate：处理在镜头打开过程中的回调，包括视频图像和人脸识别的状态结果
previewRect：人脸图片大小，间接定义的最大距离的 maxRect 和最小距离的 minRect。
detectRect：人脸检测区域大小，实际采集区域
riskDetectionSetting：风险检测超时时间，默认3秒，设置为0时跳过风险检测
sessionPresent：视频流输出格式，使用AVCaptureSessionPreset类型枚举
enableSound：采集过程中是否开启声音通知
outputImageType：返回图片类型，可以返回原图或抠图

3.3.3 视频流展示方式

视频流返回后有两种UI展现方式：

（1）UIImage展示

- (void)captureOutputSampleBuffer:(UIImage *)image;通过此方法回调的UIImage，渲染到主屏幕，实时在主线程刷新即可。

（2）PreviewLayer展示（建议方式）

使用[SSFaceDetectionManager sharedInstance];创建完detectionManager后，通过设置- (void)connectPreviewLayer:(AVCaptureVideoPreviewLayer*)pLayer;来进行PreviewLayer关联，后续镜头采集到的图像自动穿到到主界面的UI上展示。

3.3.4 Demo代码片段

参考BDFaceBaseViewController.m和BDFaceLivingConfigViewController.m实现，使用方法如下：

Objective-c

1// 初始化Layer
2self.videoPreview = [[UIView alloc]initWithFrame:self.view.frame];
3self.vPreviewLayer = [[AVCaptureVideoPreviewLayer alloc]init];
4self.vPreviewLayer.frame = self.view.frame;
5self.vPreviewLayer.videoGravity = AVLayerVideoGravityResizeAspect;
6
7[self.videoPreview.layer addSublayer:self.vPreviewLayer];
8[self.view addSubview:self.videoPreview];
9
10// 初始化采集类
11self.videoCapture = [SSFaceDetectionManager sharedInstance];
12self.videoCapture.previewRect = self.previewRect;
13self.videoCapture.detectRect = self.detectRect;
14self.videoCapture.delegate = self;
15self.videoCapture.riskDetectionSetting = 3;
16self.videoCapture.enableSound = NO;
17[self.videoCapture connectPreviewLayer:self.vPreviewLayer];
18
19// 创建人脸识别参数
20NSDictionary *parameters =  [self.videoCapture creatFaceVerifyParameters:@"身份证号" name:@"姓名" verifyType:KFaceIdCardTypeDefault nation:nil phoneNumber:@"电话" livenessControl:nil spoofingControl:nil qualityControl:nil];
21
22// 执行人脸识别流程
23[self.videoCapture startSessionWithType:BDFaceResultReportTypeVerifySec parameters:parameters faceFlow:BDFaceDetectionTypeLiveness viewController:self];
24
25// 流程回调处理
26- (void)faceCallbackWithCode:(BDFaceCompletionStatus)status result:(NSDictionary *)result {
27    if (status == BDFaceCompletionStatusSuccess) {
28       // 流程成功
29    } else if(status < 0) {
30      // 流程异常
31    }  
32}

说明：

检测图片中的人脸信息，完成人脸图像采集和人脸活体检测，返回检测状态和结果，通过SSCaptureDataOutputProtocol进行回调。

Objective-c

1// 帧图像回传，用于刷新UI使用
2- (void)captureOutputSampleBuffer:(UIImage *)image;
3
4// 本次人脸流程回调
5- (void)faceSessionCompletionWithStatus:(BDFaceCompletionStatus)status result:(NSDictionary *)result;
6
7// 活体检测状态
8- (void)livenessActionDidFinishWithCode:(LivenessRemindCode)code;
9
10// 人脸识别检测
11- (void)detectionActionDidFinishWithCode:(DetectRemindCode)code;

4、常见问题

Q：鉴权问题。提示「验证失败」 A：先确定网络情况是否正常，本地鉴权文件失效了才走网络鉴权。定位错误码，排查鉴权失败的原因。一般是 licenseID 和 bundleID 配置不一致导致的鉴权失败。请注意上线前授权文件一定要更新。

Q：license 文件失效了，不能用了怎么办？ A：License 文件申请时候有期限，如过期会导致校验失效，需要在后台进行申请延期。

Q：使用 iOS 采集端，采集到的图片是斜着的，这个正常吗，会影响识别吗？ A：不会影响识别。有黑边和倾斜是因为图片质量算法造成的，我们是按 1:3 对图像进行背景填充使人脸居中，为的是更好的识别图像。

更多问题请点击 [常见问题](

Android

增强级SDK