tencent cloud

eKYC

Release Notes and Announcements
Release Notes
Product Announcements
Product Introduction
Overview
Strengths
Use Cases
Purchase Guide
Billing Overview
Purchase Method
Payment Overdue
Refund
Integration Guide
Getting Started
Selfie Verification (Pure API)
Selfie Verification (Mobile HTML5)
Selfie Verification (App SDK)
Identity Verification (Mobile HTML5)
Identity Verification (App SDK)
Other Guide
API Documentation
History
Introduction
API Category
Making API Requests
Selfie Verification (Pure API) APIs
Selfie Verification (App SDK) APIs
Identity Verification (App SDK) APIs
Identity Verification(Mobile HTML5) APIs
AI Face Shield (Pure API) APIs
Other APIs
Data Types
Error Codes
FAQs
Contact Us
Glossary
eKYC Policy
Privacy Policy
Data Processing And Security Agreement
Service Level Agreement

iOS Custom Capabilities

PDF
Focus Mode
Font Size
Last updated: 2026-02-11 16:09:11
This document introduces the custom capabilities of the eKYC SDK (global edition).

I. Custom UI

This article mainly introduces how to use custom UI and customize recognition pages.

Construction steps

1. After decompressing the SDK compressed package, enter the demo directory and open the HuiYanODemo project.
2. Switch the building scheme to UserUIBundle, command+B can build the product.

3. After building the bundle, right-click to view the package content, open info.plist, delete the Executable file field, otherwise it will affect the AppStore listing and cause IPA upload errors. You can also delete theinfo.plistfile.

4. Replace the UserUIBundle.bundle in the SDK directory of the root directory directly with the build product, and add all libs and bundles in that directory to your own project .

Note:
If the bundle content has not been modified, you do not need to replace it and can directly use the bundles in that directory).

Customizing content

1. Custom config
Support modifying page fonts and colors. You can set it through the fields in HuiYanOsConfig.
HuiYanOsConfig *config = [[HuiYanOsConfig alloc]init];
// Set the color of the prompt text when there is an operation error
config.feedBackErrorColor = 0xFF584C;
// Set the color of prompt text when the action is correct
config.feedBackTxtColor = 0xFF0000;
// Set the color of the circular box when there is an action error
config.authCircleErrorColor = 0xFF584C;
// Set the color of the circular box when the action is correct
config.authCircleCorrectColor = 0x29CC85;
// Set the recognition page background color
config.authLayoutBgColor = 0xFFFFFF;
// Set prompt text font and size
config.feedBackTxtFont = [UIFont systemFontOfSize:18];
// Set additional prompt text size
config.feedbackExtraTxtFont = [UIFont systemFontOfSize:18];
// Set whether the internal dialog is displayed, default is YES
config.isShowDialog = YES;
// Set hidden core avatar box, default NO
config.isHideAvatarGuideFrame = NO;
2. Custom layout
Layout adjustment within Xib. If TXYOsAuthingViewController recognizes the page, you can do the following:
You can modify the layout of components within xib;
New components can be added to xib and layout can be set;
Set the Tag field for the newly added component, retrieve the authView through the onMainViewCreate: authView callback, and find the target component added through the Tag in the authView.

Set the ‘huiyanSdkUIBundlePath’ field to the SDK.
HuiYanOsConfig *config = [[HuiYanOsConfig alloc]init];
config.huiyanSdkUIBundlePath = [[NSBundle mainBundle] pathForResource:@"UserUIBundle" ofType:@"bundle"];

II. Custom language

Adding a custom language

1. The ‘UserUIBundle’ folder in the demo contains Localizable. On the right side of the figure, the supported language types can be set, and corresponding subfiles will appear on the left side.

image-20230215192445766


2. If there is no target language on the right, you can first add the corresponding language to the project settings, and then repeat step 1.

3. Translate and map the target file. The following example shows the mapping of Simplified Chinese, with the translation on the right.

image-20230215192714407


4. Set the languageBundlePath field to the SDK.
HuiYanOsConfig *config = [[HuiYanOsConfig alloc]init];
config.languageBundlePath = [[NSBundle mainBundle] pathForResource:@"UserUIBundle" ofType:@"bundle"];

// Allow specified language:
config.setLanguageFileName = @"en.lproj";
userLanguageFileName can be used to view the corresponding filename in the compiled bundle file.


Help and Support

Was this page helpful?

Help us improve! Rate your documentation experience in 5 mins.

Feedback