iOS-方案集成指南

 NSString* licensePath = [NSString stringWithFormat:@"%@.%@", FACE_LICENSE_NAME, FACE_LICENSE_SUFFIX ];
    [[FaceSDKManager sharedInstance] setLicenseID:FACE_LICENSE_ID andLocalLicenceFile:licensePath andRemoteAuthorize:true];
    NSLog(@"canWork = %d",[[FaceSDKManager sharedInstance] canWork]);
    NSLog(@"version = %@",[[FaceSDKManager sharedInstance] getVersion]);

NSString *licenseFile = [[NSBundle mainBundle] pathForResource:FACE_API_ORC_KEY ofType:FACE_SECRET_OCR_KEY];
    NSData *licenseFileData = [NSData dataWithContentsOfFile:licenseFile];
    [[AipOcrService shardService] authWithLicenseFileData:licenseFileData];
    NSLog(@"ocr sd version: %@", [AipOcrService ocrSdkVersion]);

-(void) startOCRSdk {
    [self configCallback];
    // 身份证识别
    [AipCaptureCardVC clearIdCard];
    _vc =
    [AipCaptureCardVC ViewControllerWithCardType:CardTypeLocalIdCardFont
                                 andImageHandler:^(UIImage *image) {
        _idCardImage = image;
        [[AipOcrService shardService] detectIdCardFrontFromImage:image
                                                     withOptions:nil
                                                  successHandler:^(id result){
            _successHandler(result);
        }
                                                     failHandler:_failHandler];
    }];

- (void)faceColor {
    NSArray * colorArr = [[NSArray alloc] initWithObjects:@(FaceLivenessActionTypeLiveEye), @(FaceLivenessActionTypeLiveMouth), nil];
    int r = arc4random() % [colorArr count];
    BDFaceColorfulViewController* cvc = [[BDFaceColorfulViewController alloc] init];
    BDFaceLivingConfigModel* model = [BDFaceLivingConfigModel sharedInstance];
    [cvc livenesswithList:@[colorArr[r]] order:model.isByOrder numberOfLiveness:model.numOfLiveness];
    cvc.modalPresentationStyle = UIModalPresentationFullScreen;
    cvc.name = _idCardName;
    cvc.idCardNumber = _idCardNumber;
    [self presentViewController:cvc animated:YES completion:nil];
}

- (void)faceCallbackWithCode:(BDFaceCompletionStatus)status result:(NSDictionary *)result {

    NSLog(@">>>>>>>>>>>faceCallbackWithCode, %ld  %@", (long)status,[self showCompletionStatusWithType:status]);
    MyLog(@"result = %@",result);
    NSDictionary *dic = [self dictionaryWithJsonString:result[@"data"]];
    [[BDFaceImageShow sharedInstance] setAuraLiveColor:[NSString stringWithFormat:@"licenseId:%@",dic[@"licenseId"]]];
    
    if (status == BDFaceCompletionStatusCameraStarted) {
        [self.videoCapture startRecordingVideo];
    } else if (status ==  BDFaceCompletionStatusImagesSuccess) {
        NSLog(@"%@", result);
    } else if (status == BDFaceCompletionStatusSuccess) {
        dispatch_async(dispatch_get_main_queue(), ^{
            [self.remindAnimationView stopActionAnimating];
            BDFaceVerificationController *avc = [[BDFaceVerificationController alloc] init];
            avc.modalPresentationStyle = UIModalPresentationFullScreen;
            avc.name = _name;
            avc.idCardNumber = _idCardNumber;
            avc.receivedData = result;
            if (@available(iOS 13.0, *)) {
                avc.modalPresentationStyle = 0;
            }
            [self closeAction];
            [self.presentingViewController presentViewController:avc animated:YES completion:nil];
        });

    }

- (void)livenessProcesssWithCode:(LivenessRemindCode)remindCode {
    
    dispatch_async(dispatch_get_main_queue(), ^{
        self.isAnimating = [self.remindAnimationView isActionAnimating];
    });
    
    switch (remindCode) {
        case LivenessRemindCodeOK:

- (void)colorfulProcesssWithCode:(ColorRemindCode)code imageInfo:(NSDictionary *)images {
    __weak typeof(self) weakSelf = self;
    
    NSLog(@">>>>>>>> result code:%ld, info:%@", code, images);

    switch (code) {
       case ColorRemindCodeOK:

- (void)requestSafelyToCheckIdetifierCardAndPerson:(NSDictionary *)dic {
    NSString *finantialVerificationIdCardPersonImageUrl = [NSString stringWithFormat:@"%@%@", BDFaceBaseSafeRequestBaseURL, @"/face/biz-demo/verify"];
    NSString *urlString = [NSString stringWithFormat:@"%@", finantialVerificationIdCardPersonImageUrl];
    NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:urlString]];
    NSMutableDictionary *parameters = [NSMutableDictionary dictionary];

- (void)requestSafelyToCompareImages:(NSDictionary *)dic {
    NSString *finantialVerificationImageCompareUrl = [NSString stringWithFormat:@"%@%@", BDFaceBaseSafeRequestBaseURL, @"/face/biz-demo/match"];
    NSString *urlString = [NSString stringWithFormat:@"%@", finantialVerificationImageCompareUrl];
    NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:urlString]];
    NSMutableDictionary *parameters = [NSMutableDictionary dictionary];
    
    NSString *skey = dic[@"skey"];
    NSString *xDeviceId = dic[@"x-device-id"];
    NSString *theDataString = dic[@"data"];
    NSString *appPlatform = @"ios"; // ios 必须是小写，服务端定的
    parameters[BDFaceKeyOfSkey] = skey ?: @"";
    parameters[BDFaceKeyOfXdeviceId] = xDeviceId ?: @"";
    parameters[BDFaceKeyOfApp] = appPlatform ?: @"";

    NSDictionary *tempDataDic = [NSJSONSerialization JSONObjectWithData:[theDataString dataUsingEncoding:NSUTF8StringEncoding] options:NSJSONReadingMutableLeaves error:nil];
    theDataString = tempDataDic[@"data"];
    parameters[BDFaceKeyOfData] = tempDataDic[@"data"] ?: @"";

 NSString *imageKey = [[NSUserDefaults standardUserDefaults] objectForKey:@"imagekeyfortesting"];
    parameters[BDFaceKeyOfRegisterKey] = imageKey ?: @"";

- (void)requestSafelyToCheckLive:(NSDictionary *)dic {
    NSString *finantialVerificationCheckLiveUrl =  [NSString stringWithFormat:@"%@%@", BDFaceBaseSafeRequestBaseURL, @"/face/biz-demo/faceverify"];
    NSString *urlString = [NSString stringWithFormat:@"%@", finantialVerificationCheckLiveUrl];
    NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:urlString]];
    NSMutableDictionary *parameters = [NSMutableDictionary dictionary];

#import "FaceSDKManager.h"
#import "SSFaceDetectionManager.h"

// 参数枚举等
typedef NSString *FaceIdCardType NS_STRING_ENUM;
FOUNDATION_EXPORT FaceIdCardType const KFaceIdCardTypeDefault; // 默认 大陆身份证
FOUNDATION_EXPORT FaceIdCardType const KFaceIdCardTypeMTPIDCard; // 港澳居民来往内地通行证
FOUNDATION_EXPORT FaceIdCardType const KFaceIdCardTypeFPRIDCard; // 外国人永久居留身份证
FOUNDATION_EXPORT FaceIdCardType const KFaceIdCardTypePassport; // 定居国外的中国公民护照

// 活体检测返回状态
typedef NS_ENUM(NSUInteger, LivenessRemindCode) {
    LivenessRemindCodeOK = 0,   //成功
    LivenessRemindCodeBeyondPreviewFrame,    //出框
    LivenessRemindCodeNoFaceDetected, //没有检测到人脸
    LivenessRemindCodeMuchIllumination,
    LivenessRemindCodePoorIllumination,   //光照不足
    LivenessRemindCodeImageBlured,    //图像模糊
    ...
};

/**
 *  SDK云端校验设置
 *  需要云端校验，需提前申请id和secret
 *
 *  @param clientId api key
 *  @param clientSecret api secret
 */
- (void)setBCEClientId:(NSString *)clientId clientSecret:(NSString *)clientSecret;


/**
 *  SDK鉴权方法-文件授权
 *  SDK鉴权方法 必须在使用其他方法之前设置，否则会导致SDK不可用
 *
 *  @param licenseID 授权ID
 *  @param licensePath 本地鉴权文件路径
 *  @param remoteAuthorize 是否远程更新过期鉴权文件
 */
- (void)setLicenseID:(NSString *)licenseID andLocalLicenceFile:(NSString *)licensePath andRemoteAuthorize:(BOOL)remoteAuthorize;

@interface SSFaceDetectionManager : NSObject
// 图像返回帧处理代理
@property (nonatomic, weak) id<SSCaptureDataOutputProtocol> delegate;

// 采集流程运行状态
@property (nonatomic, assign, readonly) BOOL runningStatus;

// 风险检测超时时间：-1 关闭风险检测；大于0 风险检测超时时间；0 使用默认超时时间3秒
@property (nonatomic, assign) NSInteger riskDetectionSetting;

// 设置使用镜头，前置/后置
@property (nonatomic, assign) AVCaptureDevicePosition devicePosition;

// 输出形式，AVCaptureSessionPreset类型
@property (nonatomic, copy) NSString *sessionPresent;

// 采集图像区域
@property (nonatomic, assign) CGRect previewRect;

// 探测区域
@property (nonatomic, assign) CGRect detectRect;

// 是否开启声音提醒
@property (nonatomic, assign) BOOL enableSound;

// BDFaceDetectionTypeColorfulLiveness流程中是否开启动作活体，默认开启
@property (nonatomic, assign) BOOL enableLivenessInColorfulFlow;

+ (instancetype)sharedInstance;
- (void)connectPreviewLayer:(AVCaptureVideoPreviewLayer*)pLayer;
/**
 * 创建用于实名认证的参数
 */
- (NSDictionary *)creatFaceVerifyParameters:(NSString *)idCardNumber
                                       name:(NSString *)name
                                 verifyType:(FaceIdCardType)cardType
                                     nation:(NSString *)nation
                                phoneNumber:(NSString *)phoneNumber
                            livenessControl:(FaceLivenessControlType)livenessControl
                            spoofingControl:(FaceSpoofingControlType)spoofingControl
                             qualityControl:(FaceQualityControlType)qualityControl;

/**
 * 创建用于人脸比对的参数
 */
- (NSDictionary *)createFaceMatchParametersWithRegisterImage:(NSString *)registerImageBase64
                                           registerImageType:(FaceRegisterImageType)registerImageType
                                            registerFaceType:(FaceFaceType)registerFaceType
                                                    faceType:(FaceFaceType)faceType
                                                faceSortType:(FaceSortype)faceSortType
                                                 phoneNumber:(NSString *)phoneNumber
                                             livenessControl:(FaceLivenessControlType)livenessControl
                                              qualityControl:(FaceQualityControlType)qualityControl
                                     registerLivenessControl:(FaceLivenessControlType)registerLivenessControl
                                      registerQualityControl:(FaceQualityControlType)registerQualityControl;

/**
 * 创建用于视频录制的参数
 */
- (NSDictionary *)createVideoRecordParametersWithEnableVideoRecording:(BOOL)enableVideoRecording
                                                     enableVideoSound:(BOOL)enableVideoSound
                                                        videoFileName:(NSString *)videoFileName
                                                           imageWidth:(NSUInteger)imageWidth
                                                          imageHeight:(NSUInteger)imageHeight;
/**
 * 开始当前人脸校验流程
 * @param detectionType 业务流程，采集信息用于实名认证、人脸比对
 * @param parameters 流程需要的参数
 * @param flowType 操作流程，人脸采集、人脸活体
 * @param vc 用于进行人脸信息采集的ViewController
 */
- (void)startSessionWithType:(BDFaceResultReportType)detectionType
                  parameters:(NSDictionary *)parameters
                    faceFlow:(BDFaceFlowType)flowType
              viewController:(UIViewController *)vc;


/**
 * 开始当前人脸校验流程，供视频录制时传入参数使用
 * @param detectionType 业务流程，采集信息用于实名认证、人脸比对
 * @param parameters 流程需要的参数
 * @param flowType 操作流程，人脸采集、人脸活体
 * @param vc 用于进行人脸信息采集的ViewController
 * @param videoParameters 需要录制视频的参数
 * @param cameraAutoClose 镜头是否自动关闭
 */
- (void)startSessionWithType:(BDFaceResultReportType)detectionType
                  parameters:(NSDictionary *)parameters
                    faceFlow:(BDFaceFlowType)flowType
              viewController:(UIViewController *)vc
             videoParameters:(NSDictionary *)videoParameters
             cameraAutoClose:(BOOL)cameraAutoClose;

/**
 * 取消当前人脸校验流程
 */
- (void)cancel;

/**
 * 开始视频录制，请与BDFaceCompletionStatusCameraStarted回调后调用
 */
- (void)startRecordingVideo;

/**
 * 结束当前录制，活体验证session流程结束时自动结束，不需要主动调用；BDFaceDetectionTypeVideoRecording 时主动调用
 */
- (void)stopRecordingVideo;

/**
 * 取消录制
 */
- (void)cancelRecording;

/**
 * 活体检测过程中，返回活体总数，当前成功个数，当前活体类型
 */
-(void)livenessProcessHandler:(LivenessProcess)process;

/**
 * 返回无黑边的方法
 * @param array 活体动作数组
 * @param order 是否顺序执行
 * @param numberOfLiveness 活体动作个数
 */
- (void)livenesswithList:(NSArray *)array order:(BOOL)order numberOfLiveness:(NSInteger)numberOfLiveness;

/**
 * 流程返回结果类型
 */
typedef NS_ENUM(NSInteger, BDFaceCompletionStatus) {
    BDFaceCompletionStatusSuccess = 1,  // 成功
    BDFaceCompletionStatusNoRisk = 2,   // 无风险
    BDFaceCompletionStatusImagesSuccess = 3, // 图像采集成功
    BDFaceCompletionStatusCameraStarted = 4, // 相机开始
    
    BDFaceCompletionStatusIsRunning = -1,   // 正在采集图像
    BDFaceCompletionStatusResultFail = -2,  // 云端服务执行失败
    BDFaceCompletionStatusIsRiskDevice = -3,    // 风险设备
    BDFaceCompletionStatusCameraError = -5,    // 没有授权镜头
    BDFaceCompletionStatusTimeout = -6, // 超时
    BDFaceCompletionStatusCancel = -7, // 取消
    BDFaceCompletionStatusVideoRecordingFail = -8, // 视频录制错误
    BDFaceCompletionStatusColorMatchFailed = -9, // 炫彩色彩错误
    BDFaceCompletionStatusVideoColorScoreFailed = -10, // 炫彩分数错误
    BDFaceCompletionStatusSDKNotInit = -13, // SDK未初始化
    BDFaceCompletionStatusLicenseFail = -15, // 授权错误
    BDFaceCompletionStatusNetworkError = -16,    // 网络错误
};

@protocol SSCaptureDataOutputProtocol <NSObject>

// 帧图像回传，用于刷新UI使用
- (void)captureOutputSampleBuffer:(UIImage *)image;

// 本次人脸流程回调
- (void)faceSessionCompletionWithStatus:(BDFaceCompletionStatus)status result:(NSDictionary *)result;

// 活体检测状态
- (void)livenessActionDidFinishWithCode:(LivenessRemindCode)code;

// 人脸识别检测
- (void)detectionActionDidFinishWithCode:(DetectRemindCode)code;

// 炫彩活体状态回调
- (void)colorfulActionDidFinishWithCode:(ColorRemindCode)code imageInfo:(NSDictionary *)imageInfo;

@end

// 1. 初始化Face License相关
NSString* licensePath = [NSString stringWithFormat:@"%@.%@", FACE_LICENSE_NAME, FACE_LICENSE_SUFFIX ];
[[FaceSDKManager sharedInstance] setLicenseID:FACE_LICENSE_ID andLocalLicenceFile:licensePath andRemoteAuthorize:YES];

// 2. 初始化Face相关设置属性
[[FaceSDKManager sharedInstance] setColorJudgeAbility:false]; //炫彩颜色判断能力
[[FaceSDKManager sharedInstance] setMaxCropImageNum:1];  // 设置照片采集张数，【注意：推荐设置成1张】

// 3. 设置所需动作活体动作
[[SSFaceDetectionManager sharedInstance] livenesswithList:_livenessArray order:_order numberOfLiveness:_numberOfLiveness];

// 4. 开始炫彩活体流程
NSDictionary *parameters =  [self.videoCapture creatFaceVerifyParameters:@"身份证" name:@"姓名" verifyType:KFaceIdCardTypeDefault nation:nil phoneNumber:@"电话" livenessControl:nil spoofingControl:nil qualityControl:nil]; // 业务参数

NSDictionary *videoParas = [self.videoCapture createVideoRecordParametersWithEnableVideoRecording:YES enableVideoSound:YES videoFileName:@"whatmean" imageWidth:480 imageHeight:640]; // 视频录制参数

[self.videoCapture startSessionWithType:BDFaceResultReportTypeVerifySec parameters:parameters faceFlow:BDFaceDetectionTypeColorfulLiveness viewController:self videoParameters:videoParas cameraAutoClose:YES]; // 开始流程，【注意：faceFlow参数为Colorful】

// 5. 接收回调
- (void)colorfulActionDidFinishWithCode:(ColorRemindCode)code imageInfo:(NSDictionary *)imageInfo {
   // 处理炫彩返回状态提醒
}

- (void)faceSessionCompletionWithStatus:(BDFaceCompletionStatus)status result:(NSDictionary *)result{
// 处理整体流程状态
  if (status == BDFaceCompletionStatusCameraStarted) {
    [self.videoCapture startRecordingVideo]; // 【注意：需要调用方法启动视频录制】
  } else {
    // 其他处理方式请参考demo
  }
}

 - (void)startRecognize {
    NSDictionary *parameters =  [self.videoCapture creatFaceVerifyParameters:self.idCardNumber name:self.name verifyType:KFaceIdCardTypeDefault nation:nil phoneNumber:nil livenessControl:nil spoofingControl:nil qualityControl:nil];
    NSDictionary *videoParas = [self.videoCapture createVideoRecordParametersWithEnableVideoRecording:YES enableVideoSound:YES videoFileName:@"whatmean" imageWidth:480 imageHeight:640];
    
    [self.videoCapture startSessionWithType:BDFaceResultReportTypeVerifySec parameters:parameters faceFlow:BDFaceDetectionTypeColorfulLiveness viewController:self videoParameters:videoParas cameraAutoClose:YES];
}

 - (void)faceCallbackWithCode:(BDFaceCompletionStatus)status result:(NSDictionary *)result
注意：result为识别成功后，结果的回调，状态码BDFaceCompletionStatusSuccess为整个采集流程成功结束，此时，result才有数据；BDFaceCompletionStatusImagesSuccess仅仅表示采集动作结束，此时result没有数据。

   AppDelegate *appDelegate = (AppDelegate*) [[UIApplication sharedApplication]delegate];
    if (appDelegate.useOCR == 1) {
        // OCR 身份证识别页面
        [self startOCRSdk];
    } else {
        // 手动输入页面
        BDFaceManualPersonalDataConfirmController * ocr = [[BDFaceManualPersonalDataConfirmController alloc] init];
        if (@available(iOS 13.0, *)) {
            ocr.modalPresentationStyle = 0;
        }
        [self presentViewController:ocr animated:YES completion:nil];
}

NSArray * colorArr = [[NSArray alloc] initWithObjects:@(FaceLivenessActionTypeLiveEye), @(FaceLivenessActionTypeLiveMouth), nil];
    int r = arc4random() % [colorArr count];
    BDFaceColorfulViewController* cvc = [[BDFaceColorfulViewController alloc] init];
    BDFaceLivingConfigModel* model = [BDFaceLivingConfigModel sharedInstance];
    [cvc livenesswithList:@[colorArr[r]] order:model.isByOrder numberOfLiveness:model.numOfLiveness];
    cvc.modalPresentationStyle = UIModalPresentationFullScreen;
#warning developer 这里需要加入要识别的用户的姓名和身份证号
    cvc.name = @"";
    cvc.idCardNumber = @"";
[self presentViewController:cvc animated:YES completion:nil];