VerificationConfig *config = [[VerificationConfig alloc] init];
config.languageType = HY_EKYC_ZH_HANS;

VerificationConfig *config = [[VerificationConfig alloc] init];
// 1. 启用自定义语言模式
config.languageType = HY_EKYC_CUSTOMIZE_LANGUAGE;
// 2. 指定 Bundle 的绝对路径
config.userLanguageBundlePath = [[NSBundle mainBundle] pathForResource:@"UserLanguageBundle" ofType:@"bundle"];
// 3. 指定语言文件夹名称
config.userLanguageFileName = @"ja.lproj";

OcrCustomConfig *ocrConfig = [[OcrCustomConfig alloc] init];
ocrConfig.rectNormalColor  = [UIColor whiteColor];   // 识别框正常颜色
ocrConfig.rectErrorColor   = [UIColor redColor];     // 识别框错误颜色
ocrConfig.rectPassColor    = [UIColor greenColor];   // 识别框通过颜色
ocrConfig.tipsNormalColor  = [UIColor whiteColor];   // 提示文字正常颜色
ocrConfig.tipsErrorColor   = [UIColor redColor];     // 提示文字错误颜色
ocrConfig.tipsPassColor    = [UIColor greenColor];   // 提示文字通过颜色
ocrConfig.tipsFont         = [UIFont systemFontOfSize:14]; // 提示文字字体
ocrConfig.rectScaleX       = 0.03;   // 识别框横向边距比例（0.0~0.15）
ocrConfig.rectTopMarginScale = 0.28; // 识别框顶部边距比例（仅竖屏有效）
ocrConfig.isShowTips       = YES;    // 是否显示提示文字
ocrConfig.tipsShowText     = nil;    // 自定义提示文字（nil 时显示 SDK 默认文案）

VerificationConfig *config = [[VerificationConfig alloc] init];
config.ocrCustomConfig = ocrConfig;

FaceCustomConfig *faceConfig = [[FaceCustomConfig alloc] init];
faceConfig.backgroundColor       = [UIColor blackColor]; // 背景颜色
faceConfig.tipsTextColor         = [UIColor whiteColor]; // 提示文字颜色
faceConfig.tipsTextErrorColor    = UIColorFromRGB(0xFF3B30); // 提示文字错误态颜色
faceConfig.tipsTextFont          = [UIFont systemFontOfSize:16]; // 提示文字字体
faceConfig.faceCircleErrorColor  = UIColorFromRGB(0xFF3B30); // 圆框错误态颜色
faceConfig.faceCircleCorrectColor = UIColorFromRGB(0x34C759); // 圆框正确态颜色
faceConfig.countDownTextColor    = [UIColor whiteColor]; // 倒计时文字颜色
faceConfig.cancelButtonTextColor = [UIColor whiteColor]; // 取消按钮文字颜色

VerificationConfig *config = [[VerificationConfig alloc] init];
config.faceCustomConfig = faceConfig;

VerificationConfig *config = [[VerificationConfig alloc] init];
config.delegate = self; // 实现 VerificationDelegate 协议

// VerificationDelegate 协议方法
@protocol VerificationDelegate <NSObject>
@optional
/// OCR 界面显示时回调，authView 为 SDK 展示的根视图
- (void)ocrMainViewCreate:(UIView *)authView;
/// OCR 界面被移除时回调
- (void)ocrMainViewDestroy;
/// 活体人脸比对界面显示时回调，authView 为 SDK 展示的根视图
- (void)faceMainViewCreate:(UIView *)authView;
/// 活体人脸比对界面被移除时回调
- (void)faceMainViewDestroy;
@end

@interface ViewController ()<VerificationDelegate>
@end
@implementation ViewController

// OCR界面创建回调
- (void)ocrMainViewCreate:(UIView *)authView {
    [self addCustomLabel:authView];
}

// OCR界面被回收的回调
- (void)ocrMainViewDestroy {
    NSLog(@"ekyc ocr vc destroy");
}

// 活体人脸比对界面创建回调
- (void)faceMainViewCreate:(UIView *)authView {
    [self addCustomLabel:authView];
}

// 活体人脸比对界面被回收的回调
- (void)faceMainViewDestroy {
    NSLog(@"ekyc face vc destroy");
}

- (void)addCustomLabel:(UIView *)authView {
    UILabel *label = [[UILabel alloc]initWithFrame:CGRectMake(0, 100, 100, 30)];
    label.backgroundColor = [UIColor blackColor];
    label.textColor = [UIColor yellowColor];
    label.text = @"This is a newly added control";
    label.font = [UIFont systemFontOfSize:20];
    label.textAlignment = NSTextAlignmentCenter;
        [authView addSubview:label];
}
@end


// 活体人脸比对界面创建回调
- (void)faceMainViewCreate:(UIView *)authView {
    // 修改取消按钮文字颜色和字体
    UIButton *cancelButton = (UIButton *)[authView viewWithTag:101];
    [cancelButton setTitleColor:[UIColor whiteColor] forState:UIControlStateNormal];
    [cancelButton setTitle:@"" forState:UIControlStateNormal];
    cancelButton.titleLabel.font = [UIFont systemFontOfSize:16 weight:UIFontWeightMedium];
  
  	// 修改取消按钮图片
  	UIImage *originalImage = [UIImage systemImageNamed:@"chevron.left"];
    [cancelButton setImage:originalImage forState:UIControlStateNormal];
  
  	// 修改取消按钮的 leading 左边距约束
		for (NSLayoutConstraint *constraint in cancelButton.superview.constraints) {
				if ((constraint.firstItem == cancelButton && constraint.firstAttribute == NSLayoutAttributeLeading) ||
					 (constraint.secondItem == cancelButton && constraint.secondAttribute == NSLayoutAttributeLeading)) {
						constraint.constant = 0.0;
						break;
				}
     }


    // 修改倒计时标签颜色和字体
    UILabel *timeoutLabel = (UILabel *)[authView viewWithTag:102];
    timeoutLabel.textColor = [UIColor whiteColor];
    timeoutLabel.font = [UIFont systemFontOfSize:15];
  
    // 修改虚拟导航栏颜色（仅活体人脸比对模式、活体人脸检测模式）
    UIView *navBarView = [authView viewWithTag:200];
    navBarView.backgroundColor = [UIColor redColor];
  
    // 增加导航栏标题（仅活体人脸比对模式、活体人脸检测模式）
		CGFloat statusBarHeight = [UIApplication sharedApplication].statusBarFrame.size.height;
		CGRect frame = CGRectMake(0, statusBarHeight, navBarView.bounds.size.width, navBarView.bounds.size.height - statusBarHeight);
		UILabel *label = [[UILabel alloc]initWithFrame:frame];
		label.text = @"Custom Title";
		label.textColor = [UIColor blackColor];
		label.textAlignment = NSTextAlignmentCenter;
		[navBarView addSubview:label];
}


config.delegate = self;
​
- (BOOL)onOcrCloudErrorDialog:(NSDictionary *)info
                  parentView:(UIView *)parentView
                  retryBlock:(nullable void(^)(void))retryBlock
                   exitBlock:(void(^)(void))exitBlock {
   NSString *title   = info[HYEkycDialogInfoKeyTitle];
   NSString *message = info[HYEkycDialogInfoKeyMessage];
   UIAlertController *alert = [UIAlertController alertControllerWithTitle:title
                                                                  message:message
                                                           preferredStyle:UIAlertControllerStyleAlert];
   if (retryBlock) {
      [alert addAction:[UIAlertAction actionWithTitle:@"Retry"
                                                style:UIAlertActionStyleDefault
                                              handler:^(UIAlertAction *a) { retryBlock(); }]];
  }
  [alert addAction:[UIAlertAction actionWithTitle:@"Exit"
                                            style:UIAlertActionStyleCancel
                                          handler:^(UIAlertAction *a) { exitBlock(); }]];
   UIViewController *vc = parentView.window.rootViewController;
   while (vc.presentedViewController) vc = vc.presentedViewController;
  [vc presentViewController:alert animated:YES completion:nil];
   return YES;
}


config.delegate = self;

- (BOOL)onEkycShowLoading:(NSDictionary *)info parentView:(UIView *)parentView {
    NSString *type = info[HYEkycLoadingInfoKeyType];
    NSString *text = @"Processing...";
    if ([type isEqualToString:HYEkycLoadingTypeResultUploading]) {
        text = @"Uploading...";
    } else if ([type isEqualToString:HYEkycLoadingTypeImagePicking]) {
        text = @"Opening Album...";
    }
    [MyCustomLoadingView showInView:parentView withText:text];
    return YES;
}

- (BOOL)onEkycHideLoading:(UIView *)parentView {
    [MyCustomLoadingView hideFromView:parentView];
    return YES;
}

demo/
└── UserUIBundle/
    ├── TXYOsAuthingViewController.xib   # 活体人脸比对页面
    └── CustOcrView.xib                  # 证件识别页面

VerificationConfig *config = [[VerificationConfig alloc] init];

// 指定自定义 UI Bundle 的绝对路径
config.userUIBundlePath = [[NSBundle mainBundle] pathForResource:@"UserUIBundle" ofType:@"bundle"];

VerificationConfig *config = [[VerificationConfig alloc] init];
config.licPath    = @"/path/to/license.lic";
config.ekycToken  = @"your-ekyc-token";

// --- 自定义 UI ---
config.userUIBundlePath = [[NSBundle mainBundle] pathForResource:@"UserUIBundle" ofType:@"bundle"];
config.delegate = self;  // 可选：实现 VerificationDelegate 监听 UI 事件

// 代码级样式微调（可选，不需要修改 XIB 时使用）
config.ocrCustomConfig.rectNormalColor = [UIColor colorWithWhite:1.0 alpha:0.8];
config.faceCustomConfig.backgroundColor = [UIColor colorWithRed:0.1 green:0.1 blue:0.1 alpha:1.0];

// --- 自定义多语言 ---
config.languageType = HY_EKYC_CUSTOMIZE_LANGUAGE;
config.userLanguageBundlePath = [[NSBundle mainBundle] pathForResource:@"UserLanguageBundle" ofType:@"bundle"];
config.userLanguageFileName = @"ja.lproj";

// 启动验证
VerificationKit *kit = [[VerificationKit alloc] init];
[kit initWithViewController:self];
[kit startVerifiWithConfig:config withSuccCallback:^(int errorCode, id resultInfo, id reserved) {
    // 验证成功
} withFailCallback:^(int errorCode, NSString *errorMsg, id reserved) {
    // 验证失败，错误码 311 表示 Bundle 路径配置异常
}];

// 旧写法（v1.0.1.4 及以下）
config.userUIBundleName = @"UserUIBundle";
config.userLanguageBundleName = @"UserLanguageBundle";

// 新写法（v1.0.1.5 及以上）
config.userUIBundlePath = [[NSBundle mainBundle] pathForResource:@"UserUIBundle" ofType:@"bundle"];
config.userLanguageBundlePath = [[NSBundle mainBundle] pathForResource:@"UserLanguageBundle" ofType:@"bundle"];