IOS

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

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

- (BOOL)canWork

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

/**
 * 获取版本号
 */
- (NSString *)getVersion;

/**
 *  重置计数器
 */
- (void)reset;

/**
 * 获取设备zid 公安验证上传
 */
- (NSString *)getZtoken;

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

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

/**
 *  初始化采集功能
 */
- (int) initCollect;

/**
 *  卸载采集功能
 */
- (int)uninitCollect;

/**
 *  判断授权是否通过，true 表示通过，false 表示不通过
 */
- (BOOL)canWork;

/**
 *  设置预测库耗能模式
 *  默认 LITE_POWER_NO_BIND
 */
- (void)setLitePower:(int)litePower;

/**
 *  需要检测的最大人脸数目
 *  默认1
 */
- (void)setMaxDetectNum:(int)detectNum ;

/**
 *  需要检测的最小人脸大小
 *  默认40
 */
- (void)setMinFaceSize:(int)width;

/**
 *  人脸置信度阈值（检测分值大于该阈值认为是人脸
 *  RGB
 *  默认 0.5f
 */
- (void)setNotFaceThreshold:(CGFloat)thr ;

/**
 *  质量检测遮挡阈值
 *  默认0.5
 */
- (void)setOccluThreshold:(CGFloat)thr ;

/**
 * 质量检测遮挡阈值-左眼遮挡置信度
 * 默认0.31
 */
-(void)setOccluLeftEyeThreshold:(CGFloat)thr ;

/**
 * 质量检测遮挡阈值- 右眼遮挡置信度
 * 默认0.31
 */
-(void)setOccluRightEyeThreshold:(CGFloat)thr ;

/**
 * 质量检测遮挡阈值-鼻子遮挡置信度
 * 默认0.27
 */
-(void)setOccluNoseThreshold:(CGFloat)thr ;

/**
 * 质量检测遮挡阈值-嘴巴遮挡置信度
 * 默认0.2
 */
-(void)setOccluMouthThreshold:(CGFloat)thr ;

/**
 * 质量检测遮挡阈值-左脸遮挡置信度
 * 默认0.48
 */
-(void)setOccluLeftCheekThreshold:(CGFloat)thr ;

/**
 * 质量检测遮挡阈值-右脸遮挡置信度
 * 默认0.48
 */
-(void)setOccluRightCheekThreshold:(CGFloat)thr ;

/**
 * 质量检测遮挡阈值-下巴遮挡置信度
 * 默认0.4
 */
-(void)setOccluChinThreshold:(CGFloat)thr ;


/**
 * 最大光照阈值
 */
- (void)setMaxIllumThreshold:(CGFloat)thr;

/**
 * 最小光照阈值
 */
- (void)setMinIllumThreshold:(CGFloat)thr ;

/**
 *  质量检测模糊阈值
 *  默认0.5
 */
- (void)setBlurThreshold:(CGFloat)thr ;

/**
 *  姿态检测阈值
 *  默认pitch=12，yaw=12，row=10
 */
- (void)setEulurAngleThrPitch:(float)pitch yaw:(float)yaw roll:(float)roll ;

/**
 * 输出图像个数
 * 默认3
 */
- (void)setMaxCropImageNum:(int)imageNum ;

/**
 * 输出图像宽，设置为有效值(大于0)则对图像进行缩放，否则输出原图抠图结果
 * 默认 480
 */
- (void)setCropFaceSizeWidth:(CGFloat)width ;

/**
 * 输出图像高，设置为有效值(大于0)则对图像进行缩放，否则输出原图抠图结果
 * 默认 680
 */
- (void)setCropFaceSizeHeight:(CGFloat)height ;

/**
 * 输出图像，下巴扩展，大于等于0，0：不进行扩展
 * 默认0.1
 */
- (void)setCropChinExtend:(CGFloat)chinExtend ;

/**
 * 输出图像，额头扩展，大于等于0，0：不进行扩展
 * 默认0.2
 */
- (void)setCropForeheadExtend:(CGFloat)foreheadExtend ;

/**
 * 输出图像，人脸框与背景比例，大于等于1，1：不进行扩展
 * 默认1.5f
 */
- (void)setCropEnlargeRatio:(float)cropEnlargeRatio;

/**
 * 动作超时配置
 */
- (void)setConditionTimeout:(CGFloat)timeout ;

/**
 * 语音间隔提醒配置
 */
- (void)setIntervalOfVoiceRemind:(CGFloat)timeout;

/**
 * 是否开启口罩检测，非动作活体检测模型true，动作活体检测模型false
 */
- (void)setIsCheckMouthMask:(BOOL)isCheck;

/**
 * 口罩检测阈值配置，默认0.8。
 * 大于阈值判定为戴口罩，低于阈值判定为未戴口罩
 */
- (void)setMouthMaskThreshold:(CGFloat)thr ;

/**
 * 设置原始图片缩放比例，默认1不缩放，scale 阈值0~1
 */
- (void)setImageWithScale:(CGFloat)scale;

/**
 * 设置图片加密类型，type=0 基于base64 加密；type=1 基于百度安全算法加密
 */
- (void)setImageEncrypteWithType:(int) type;

/**
 *  人脸过远框比例 默认：0.4
 */
- (void)setMinRect:(float) minRectScale;
/**
 * 采集动作验证
 * @param image 检测的图片
 * @param isOriginal 是否返回原始图片
 * @param completion 判断采集是否完成，人脸信息状态是否正常
 */
- (void)detectWithImage:(UIImage *)image isRreturnOriginalValue:(BOOL) isOriginal completion:(void (^)(FaceInfo *faceinfo, ResultCode resultCode))completion;

/**
 * 动作活体动作验证
 * @param image 检测的图片
 * @param actionLiveType 当前要求做的动作
 * @param completion 判断当前动作是否完成，人脸信息状态是否正常
 */
- (void)livenessWithImage:(UIImage *)image withAction:(FaceLivenessActionType)actionLiveType completion:(void (^)(FaceInfo *faceinfo, FaceLivenessState *state, ResultCode resultCode))completion;

/**
 * 设置活体动作
 * @param array 包含活体动作种类
 * @param order 是否顺序执行
 * @param numberOfLiveness 活体数量
 */
- (void)livenesswithList:(NSArray *)array order:(BOOL)order numberOfLiveness:(NSInteger)numberOfLiveness;

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

- (int)initCollect;

- (void) initSDK {
     if (![[SSFaceSDKManager sharedInstance] canWork]){
        NSLog(@"授权失败，请检测ID 和 授权文件是否可用");
        return;
    }
    
    // 初始化SDK配置参数，可使用默认配置
    // 设置最小检测人脸阈值
    [[SSFaceSDKManager sharedInstance] setMinFaceSize:200];
    // 设置截取人脸图片高
    [[SSFaceSDKManager sharedInstance] setCropFaceSizeWidth:480];
    // 设置截取人脸图片宽
    [[SSFaceSDKManager sharedInstance] setCropFaceSizeHeight:640];
    // 设置人脸遮挡阈值
    [[SSFaceSDKManager sharedInstance] setOccluThreshold:0.5];
    // 设置亮度阈值
    [[SSFaceSDKManager sharedInstance] setMinIllumThreshold:40];
    [[SSFaceSDKManager sharedInstance] setMaxIllumThreshold:240];
    // 设置图像模糊阈值
    [[SSFaceSDKManager sharedInstance] setBlurThreshold:0.3];
    // 设置头部姿态角度
    [[SSFaceSDKManager sharedInstance] setEulurAngleThrPitch:10 yaw:10 roll:10];
    // 设置人脸检测精度阈值
    [[SSFaceSDKManager sharedInstance] setNotFaceThreshold:0.6];
    // 设置抠图的缩放倍数
    [[SSFaceSDKManager sharedInstance] setCropEnlargeRatio:2.5];
    // 设置照片采集张数
    [[SSFaceSDKManager sharedInstance] setMaxCropImageNum:3];
    // 设置超时时间
    [[SSFaceSDKManager sharedInstance] setConditionTimeout:15];
    // 设置开启口罩检测，非动作活体检测可以采集戴口罩图片
    [[SSFaceSDKManager sharedInstance] setIsCheckMouthMask:true];
    // 设置开启口罩检测情况下，非动作活体检测口罩过滤阈值，默认0.8 不需要修改
    [[SSFaceSDKManager sharedInstance] setMouthMaskThreshold:0.8f];
    // 设置原始图缩放比例
    [[SSFaceSDKManager sharedInstance] setImageWithScale:0.8f];
    // 初始化SDK功能函数
    [[SSFaceSDKManager sharedInstance] initCollect];
    // 设置人脸过远框比例
    [[SSFaceSDKManager sharedInstance] setMinRect:0.4];
    
    /// 设置用户设置的配置参数
    [BDFaceAdjustParamsTool setDefaultConfig];
}

- (int)uninitCollect

/**
 * 流程返回结果类型
 */
typedef NS_ENUM(NSInteger, BDFaceCompletionStatus) {
    BDFaceCompletionStatusSuccess = 1,  // 成功
    BDFaceCompletionStatusNoRisk = 2,   // 无风险
    BDFaceCompletionStatusImagesSuccess = 3, // 图像采集成功
    
    BDFaceCompletionStatusIsRunning = -1,   // 正在采集图像
    BDFaceCompletionStatusResultFail = -2,  // 云端服务执行失败
    BDFaceCompletionStatusIsRiskDevice = -3,    // 风险设备
    BDFaceCompletionStatusCameraError = -5,    // 没有授权镜头
    BDFaceCompletionStatusTimeout = -6, // 超时
    BDFaceCompletionStatusCancel = -7, // 取消
    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;

@end
@interface SSFaceDetectionManager : NSObject

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

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

// 风险检测超时时间，默认3秒
@property (nonatomic, assign) NSInteger riskDetectionSetting;

// AVCaptureSessionPreset类型枚举，支持低版本所以使用NSString
@property (nonatomic, copy) NSString *sessionPresent;

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

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

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

// 返回图片类型
@property (nonatomic, assign) BDFaceOutputImageType outputImageType;


+ (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;


/**
 * 开始当前人脸校验流程
 * @param detectionType 业务流程，采集信息用于实名认证、人脸比对
 * @param parameters 流程需要的参数
 * @param flowType 操作流程，人脸采集、人脸活体
 * @param vc 用于进行人脸信息采集的ViewController
 */
- (void)startSessionWithType:(BDFaceResultReportType)detectionType parameters:(NSDictionary *)parameters faceFlow:(BDFaceFlowType)flowType viewController:(UIViewController *)vc;

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

@end

// 初始化Layer
self.videoPreview = [[UIView alloc]initWithFrame:self.view.frame];
self.vPreviewLayer = [[AVCaptureVideoPreviewLayer alloc]init];
self.vPreviewLayer.frame = self.view.frame;
self.vPreviewLayer.videoGravity = AVLayerVideoGravityResizeAspect;

[self.videoPreview.layer addSublayer:self.vPreviewLayer];
[self.view addSubview:self.videoPreview];

// 初始化采集类
self.videoCapture = [SSFaceDetectionManager sharedInstance];
self.videoCapture.previewRect = self.previewRect;
self.videoCapture.detectRect = self.detectRect;
self.videoCapture.delegate = self;
self.videoCapture.riskDetectionSetting = 3;
self.videoCapture.enableSound = NO;
[self.videoCapture connectPreviewLayer:self.vPreviewLayer];

// 创建人脸识别参数
NSDictionary *parameters =  [self.videoCapture creatFaceVerifyParameters:@"身份证号" name:@"姓名" verifyType:KFaceIdCardTypeDefault nation:nil phoneNumber:@"电话" livenessControl:nil spoofingControl:nil qualityControl:nil];

// 执行人脸识别流程
[self.videoCapture startSessionWithType:BDFaceResultReportTypeVerifySec parameters:parameters faceFlow:BDFaceDetectionTypeLiveness viewController:self];

// 流程回调处理
- (void)faceCallbackWithCode:(BDFaceCompletionStatus)status result:(NSDictionary *)result {
    if (status == BDFaceCompletionStatusSuccess) {
       // 流程成功
    } else if(status < 0) {
      // 流程异常
    }  
}

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

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

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

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