Files
featherVoice/TencentCloudHuiyanSDKFace_framework/Libs/YTFaceLiveReflect.framework/Headers/YTFaceHandle.h

191 lines
6.2 KiB
C
Raw Normal View History

2025-08-08 10:49:36 +08:00
//
// YTFaceHandle.h
// FaceVideoTest
//
// Created by CosperYu on 2019/02/28.
// Copyright © 2019 Tencent. All rights reserved.
//
#import <UIKit/UIKit.h>
#import "DataDef.h"
#import <AVFoundation/AVFoundation.h>
#import <sys/utsname.h>
#import "YTAGReflectDeviceDelegate.h"
#import <CommonCrypto/CommonCrypto.h>
#ifndef YTFaceHandle_h
#define YTFaceHandle_h
//#define YT_ENCODE_REFLECT_DATA
using namespace std;
// Comment this version define avoid redefined and use interfaces instead.
#define YT_FACE_REFLECT_VERSION @"3.7.4"
//活体类型
enum YTLIVETYPE {
LIVETYPE_REFLECT = 1, //反光
LIVETYPE_POSE = 2, //动作
};
//服务器回调验证
enum YTSERVERCHECK_TYPE {
YTSERVERCHECK_INPUTPARAM_NULL = -1, //入参为空
YTSERVERCHECK_CHECKPASS = 0, //检测通过
//反光验证使用
YTSERVERCHECK_REFLECT_FAILED = 1, //反光验证失败
YTSERVERCHECK_PICTURE_FAILED = 2, //防翻拍验证失败
YTSERVERCHECK_COMPARE_FAILED = 3, //对比失败
};
enum YTREFLECT_SAFETY_LEVEL {
YTREFLECT_SAFETY_RECOMMAND = 0, //推荐大小反光上传数据大概500K
YTREFLECT_SAFETY_LOW = 1, //低安全性上传包体大概300K。若网络环境或者破解要求没那么高的场景使用
YTREFLECT_SAFETY_HIGH = 2, //高安全性上传包体可能会到2M。微信在用
YTREFLECT_SAFETY_COUNT = 3
};
/*
@brief
@param ret:
0
-1 clearAG终止反光
-1491
-1493 sdk内部错误
-1494 iso变光点时序不正确sdk内部错误造成
@param fullPack:
*/
typedef void (^onFinish)(int ret, YTFullPack fullPack);
typedef void (^onDalayCalc)();
typedef void (^onReflectLiveImgData)(YTRawImgData frame);
/*
@brief rgb请求
@param rgbconfig: rgb序列
@param error: nil
*/
typedef void (^YTRgbconfigParseResult)(NSString* _Nullable rgbconfig, NSError *_Nullable error);
/**
@brief
@param rgb
@param light
*/
typedef void (^YTReflectEventCallback)(uint argb ,CGFloat light);
/**
@brief SDK日志注册回调
@param level 0 - error 1 - warn 2 - info 3 - error)
@param message
*/
typedef void (^OnYTFaceReflectSDKLoggerEventBlock)(int level, NSString * _Nonnull message);
@interface YTFaceHandle : NSObject
#pragma mark - Global Interface
/**
* 0 RGB
* 1 BGR
*/
@property (assign, nonatomic) int innerImgType;
@property (assign, nonatomic) float compressReflectionImageScore;
/**
@brief
@param level 0 - error 1 - warn 2 - info 3 - error)
@param listener
*/
+ (void)registerSDKLogger:(int) level withListener:(OnYTFaceReflectSDKLoggerEventBlock _Nullable)listener;
+ (NSString * _Nonnull)checksum:(NSString * _Nonnull)act_str withData:(id _Nonnull)data;
#pragma mark - Life Circle
/**
*
* @param key is_alone_raw_push是否流式传输() 1 is_shorten_strategy () 1
* @param value
*/
- (void)updateParam:(NSString * _Nonnull)key withValue:(NSString * _Nonnull)value;
/**
@brief
@param appId: appid
@param extraData: ppl version
*/
- (id _Nullable )initWithAppId:(NSString*_Nonnull)appId withExtraData:(NSString *_Nullable)extraData;
/**
@brief
@param callback
*/
- (void)setReflectEvent:(YTReflectEventCallback _Nonnull)callback;
/**
@brief sdk版本
@return
*/
- (const NSString * _Nonnull)getVersion;
/**
@brief
@param rgbConfig:
@param device:YTAGReflectDeviceDelegate协议的对象
@param shapeView: view
@param onDalayCalc:
@param onFinish: onFinish定义线
@return error code:
0
-1 CP_string格式组成不正确
-2 device为空
-3 shapeView为空
-4 onDalayCalc为空
-5 onFinish为空
-1024
@warning 1线
2线使
*/
- (NSInteger)initAG:(NSString *_Nonnull)rgbConfig
device:(id<YTAGReflectDeviceDelegate> _Nonnull)device
shapeView:(UIView* _Nullable)shapeView
onDalayCalc:(onDalayCalc _Nonnull)onDalayCalc
onFinish:(onFinish _Nonnull)onFinish
onReflectLiveImgData:(onReflectLiveImgData _Nonnull)onReflectLiveImgData
outputDurationMS:(long &)durationMS;
/**
@brief
@return
*/
- (NSString * _Nonnull)AutoGenRgb:(int)rgbNum mode:(NSString * _Nonnull)mode;
/**
@brief
@param faceImageCrop:
@param faceAlign:
@param timeStamp:
*/
- (void)PushImgSequence:(void*_Nonnull)faceRgbMat faceAlign:(NSMutableArray* _Nonnull)faceAlign timeStamp:(uint64_t)timeStamp;
//终止反光并清理反光数据调用后如需再次反光需要重新调用initAG
//可以在反光过程的任意阶段调用,如用户反光过程来电或者其他原因希望结束反光验证时
//正常流程下依然建议使用demo的方式反光过程进行界面锁定避免用户不必要的操作
- (void)clearAG;
#pragma mark - Settings
//安全性设置,参照 YTSAFETYLEVEL
- (void)setSafety:(YTREFLECT_SAFETY_LEVEL) value;
- (int)getSafety;
#pragma mark - Utility
//检测是否睁眼
//反光开始前需要用户睁眼,以避免沉睡状态下通过了反光验证
- (float) precheckCloseEye:(const NSMutableArray* _Nonnull) att;
////临时存储图的路径(测试用)
//-(void)setSavePath:(NSString* _Nonnull)savePath;
@end
#endif /* YTFaceHandle_h */