// // WBFaceVerifyCustomerService.h // WBFaceV2 // // Created by tank on 25/10/2016. // Copyright © 2016 tencent. All rights reserved. // /** 注意拉起页面的方式: SDK会创建一个UIWindow覆盖在当前界面,并在新创建的UIWindow界面进行人脸认证,并且可以通过实现 wbfaceVerifyServiceGetWindowLevel 代理方法,传入创建的UIWindow的windowLevel, 传入的windowLevel必须是1~999, 默认情况如果不实现 wbfaceVerifyServiceGetWindowLevel 方法,windowLevel = UIWindowLevelNormal + 1 */ #import #import "WBFaceVerifyConst.h" #import "WBFaceVerifySDKConfig.h" #import "WBFaceVerifyResult.h" NS_ASSUME_NONNULL_BEGIN // SDK在运行结束退出时候会发出通知. 具体的通知内容可以见delegate方法wbfaceVerifyCustomerServiceDidFinished:中的注释 UIKIT_EXTERN NSString *const WBFaceVerifyCustomerServiceDidFinishedNotification; @class WBFaceVerifyCustomerService; /** 处理刷脸回调 */ @protocol WBFaceVerifyCustomerServiceDelegate @optional -(void)wbfaceVerifyCustomerServiceWillUploadBestImage:(UIImage *)bestImage; @required -(void)wbfaceVerifyCustomerServiceDidFinishedWithFaceVerifyResult:(WBFaceVerifyResult *)faceVerifyResult; @end @interface WBFaceVerifyCustomerService : NSObject @property (nullable,nonatomic,weak) id delegate; @property (nonatomic, assign, readonly) BOOL isService; /* 全局唯一单例 */ +(instancetype)sharedInstance; /* 初始化云刷脸sdk，仅做参数初始化与登陆，不拉起刷脸页面 登陆有时效性，建议在登陆完成后success回调中拉起刷脸页面！！ 登陆过程为异步操作，多次登陆以最后一次收到的结果为准！！ 此SDK接口中 合作方后台开发需要通过后台接口获取sign, 然后根据自带比对源接口, 通过后台接口获取faceId!!!!(native端无需传入自带比对源图) *** faceId为空时，启用仅活体检测服务，不做比对 ！！！ 注意, 请使用 dispatch_async(dispatch_get_main_queue(), ^{ }); 异步调用SDK的入口方法 @param userid 用户唯一标识, 由合作方自行定义（具体要求，参考word接入文档） @param nonce 满足接入要求的32位随机数（具体要求，参考word接入文档） @param sign 满足接入要求的40位签名值（具体要求，参考word接入文档） @param appid 腾讯服务分配的appid @param orderNo 每次人脸身份认证请求的唯一订单号: 建议为32位字符串(不超过32位) @param apiVersion 后台api接口版本号(不是SDK的版本号),默认请填写@"1.0.0" @param licence 腾讯给合作方派发的前端使用的licence(该licence同app当前使用的bundle id绑定) @param faceId 合作方必须要先在获取faceId的接口里送入用户自带比对源图片信息，得到相应的faceId后，再送入sdk!!!!(参考word接入文档) *** faceId为空时，启用仅活体检测服务，不做比对 ！！！ @param sdkConfig SDK基础配置项目 @param success 服务登录成功回调,登录成功以后开始进行活体和检测服务 @param failure 服务登录失败回调,具体参考错误码文档(参考word接入文档) */ -(void)initSDKWithUserId:(NSString *)userid nonce:(NSString *)nonce sign:(NSString *)sign appid:(NSString *)appid orderNo:(NSString *)orderNo apiVersion:(NSString *)apiVersion licence:(NSString *)licence faceId:(nullable NSString *)faceId sdkConfig:(WBFaceVerifySDKConfig *)sdkConfig success:(void (^)(void))success failure:(void (^)(WBFaceError * _Nonnull error))failure; /* Plus级SDK核身入口，注意传入的faceId不能为空，否则会报failure @param userid 用户唯一标识, 由合作方自行定义（具体要求，参考word接入文档） @param nonce 满足接入要求的32位随机数（具体要求，参考word接入文档） @param sign 满足接入要求的40位签名值（具体要求，参考word接入文档） @param appid 腾讯服务分配的appid @param orderNo 每次人脸身份认证请求的唯一订单号: 建议为32位字符串(不超过32位) @param apiVersion 后台api接口版本号(不是SDK的版本号),默认请填写@"1.0.0" @param licence 腾讯给合作方派发的前端使用的licence(该licence同app当前使用的bundle id绑定) @param faceId 合作方必须要先获取*增强级*faceId，再送入sdk，不允许为空(参考word接入文档) @param sdkConfig SDK基础配置项目 @param success 服务登录成功回调,登录成功以后开始进行活体和检测服务 @param failure 服务登录失败回调,具体参考错误码文档(参考word接入文档) */ - (void)initPlusSDKWithUserId:(NSString *)userid nonce:(NSString *)nonce sign:(NSString *)sign appid:(NSString *)appid orderNo:(NSString *)orderNo apiVersion:(NSString *)apiVersion licence:(NSString *)licence faceId:(nullable NSString *)faceId sdkConfig:(WBFaceVerifySDKConfig *)sdkConfig success:(void (^)(void))success failure:(void (^)(WBFaceError * _Nonnull error))failure; /* 增强级SDK核身入口，注意传入的faceId不能为空，且必须为增强faceId，否则会报failure @param userid 用户唯一标识, 由合作方自行定义（具体要求，参考word接入文档） @param nonce 满足接入要求的32位随机数（具体要求，参考word接入文档） @param sign 满足接入要求的40位签名值（具体要求，参考word接入文档） @param appid 腾讯服务分配的appid @param orderNo 每次人脸身份认证请求的唯一订单号: 建议为32位字符串(不超过32位) @param apiVersion 后台api接口版本号(不是SDK的版本号),默认请填写@"1.0.0" @param licence 腾讯给合作方派发的前端使用的licence(该licence同app当前使用的bundle id绑定) @param faceId 合作方必须要先获取*增强级*faceId，再送入sdk，不允许为空(参考word接入文档) @param sdkConfig SDK基础配置项目 @param success 服务登录成功回调,登录成功以后开始进行活体和检测服务 @param failure 服务登录失败回调,具体参考错误码文档(参考word接入文档) */ -(void)initAdvanceSDKWithUserId:(NSString *)userid nonce:(NSString *)nonce sign:(NSString *)sign appid:(NSString *)appid orderNo:(NSString *)orderNo apiVersion:(NSString *)apiVersion licence:(NSString *)licence faceId:(nonnull NSString *)faceId sdkConfig:(WBFaceVerifySDKConfig *)sdkConfig success:(void (^)(void))success failure:(void (^)(WBFaceError * _Nonnull error))failure; /** 以上一次的登陆结果拉起刷脸页面，必须先登录再拉起刷脸页面 @return 拉起是否成功 */ - (BOOL)startWbFaceVeirifySdk; #pragma mark - 意愿性表达接口 /* 意愿性SDK入口，注意传入的faceId不能为空 @param userid 用户唯一标识, 由合作方自行定义（具体要求，参考word接入文档） @param nonce 满足接入要求的32位随机数（具体要求，参考word接入文档） @param sign 满足接入要求的40位签名值（具体要求，参考word接入文档） @param appid 腾讯服务分配的appid @param orderNo 每次人脸身份认证请求的唯一订单号: 建议为32位字符串(不超过32位) @param apiVersion 后台api接口版本号(不是SDK的版本号),默认请填写@"1.0.0" @param licence 腾讯给合作方派发的前端使用的licence(该licence同app当前使用的bundle id绑定) @param faceId 合作方必须要先获取*增强级*faceId，再送入sdk，不允许为空(参考word接入文档) @param sdkConfig SDK基础配置项目 @param success 服务登录成功回调,登录成功以后开始进行活体和检测服务 @param failure 服务登录失败回调,具体参考错误码文档(参考word接入文档) */ -(void)initWillSDKWithUserId:(NSString *)userid nonce:(NSString *)nonce sign:(NSString *)sign appid:(NSString *)appid orderNo:(NSString *)orderNo apiVersion:(NSString *)apiVersion licence:(NSString *)licence faceId:(nonnull NSString *)faceId sdkConfig:(WBFaceVerifySDKConfig *)sdkConfig success:(void (^)(void))success failure:(void (^)(WBFaceError * _Nonnull error))failure; @end NS_ASSUME_NONNULL_END