178 lines
8.8 KiB
C
178 lines
8.8 KiB
C
|
//
|
|||
|
|
// 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 <UIKit/UIKit.h>
|
|||
|
|
#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 <NSObject>
|
|||
|
|
@optional
|
|||
|
|
-(void)wbfaceVerifyCustomerServiceWillUploadBestImage:(UIImage *)bestImage;
|
|||
|
|
|
|||
|
|
@required
|
|||
|
|
-(void)wbfaceVerifyCustomerServiceDidFinishedWithFaceVerifyResult:(WBFaceVerifyResult *)faceVerifyResult;
|
|||
|
|
@end
|
|||
|
|
|
|||
|
|
@interface WBFaceVerifyCustomerService : NSObject
|
|||
|
|
@property (nullable,nonatomic,weak) id<WBFaceVerifyCustomerServiceDelegate> 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
|