Release Notes

v4.3.0 (2026.09.04) Download

Bug Fixes

Fixed a PARAMETER_ERROR issue triggered when stopRunning is called while an upload is in progress.

Breaking changes

Remove experimental properties currAvatarPreviewArea and currPreviewFrame from AAILivenessWrapView.

New feature

Add getSupportedApplicationIds method for AAILivenessSDK to help you check why you got the "APPLICATION_ID_NOT_MATCH" error.

When configLicenseAndCheck: returns "APPLICATION_ID_NOT_MATCH", it means your app's bundle identifier does not match the one bound to the license. You can call this method to get the bundle identifiers that the current license supports, then compare them with your app's actual bundle identifier to locate the mismatch.

Update

Refined face pose verification and head shake amplitude during motion-based liveness checks.
Enhanced SDK security via stricter data validation.

Migration Guides

When migrating from old version to this version, you need to:

Add the aai-specs pod spec source and change the dependency version

source 'https://cdn.cocoapods.org/'
source 'https://github.com/advance-ai-mobile/aai-specs'

pod 'AAILivenessSDK', '4.3.0' # This module automatically fetches AAICore(1.0.6) and AAINetwork(1.1.0).
pod 'AAILivenessUI', '4.3.0'
pod 'AAILivenessModel', '4.2.0'
pod 'AAIDataVisorSDK', '0.1.7'

Then run pod install --repo-update.

v4.2.2 (2026.07.24) Download

Bug Fixes

Fix an occasional crash caused by "[__NSDictionaryM length]: unrecognized selector".

Update

Refine face position checks for silent and motion-based liveness detection to optimize user experience.
Remove useless properties prepareStartTime and _timeoutIntervalInSecForAction from AAILivenessViewController.m.

Migration Guides

When migrating from old version to this version, you need to:

Add the aai-specs pod spec source and change the dependency version

source 'https://cdn.cocoapods.org/'
source 'https://github.com/advance-ai-mobile/aai-specs'

pod 'AAILivenessSDK', '4.2.2' # This module automatically fetches AAICore(1.0.5) and AAINetwork(1.1.0).
pod 'AAILivenessUI', '4.2.2'
pod 'AAILivenessModel', '4.2.0'
pod 'AAIDataVisorSDK', '0.1.7'

Then run pod install --repo-update.

v4.2.1 (2026.07.14) Download

Bug Fixes

Fixed custom font on AAILivenessViewController ignoring the host-specified point size (state / timeout labels).

Migration Guides

When migrating from old version to this version, you need to:

Add the aai-specs pod spec source and change the dependency version

source 'https://cdn.cocoapods.org/'
source 'https://github.com/advance-ai-mobile/aai-specs'

pod 'AAILivenessSDK', '4.2.0' # This module automatically fetches AAICore(1.0.4) and AAINetwork(1.1.0).
pod 'AAILivenessUI', '4.2.1'
pod 'AAILivenessModel', '4.2.0'
pod 'AAIDataVisorSDK', '0.1.7'

Then run pod install --repo-update.

v4.2.0 (2026.05.15) Download

Optimization

Enhanced liveness image capture quality.

Bug Fixes

Fixed an occasional issue where the data upload loading view kept showing and never ended.
Fixed innerAnimatedEllipseLineColor in AAILivenessConfig not taking effect.
Fixed an occasional crash caused by loading model files.

New feature

Supports minimum camera resolution limitation. If a minimum resolution is configured in the backend, the SDK will throw a CAMERA_RESOLUTION_TOO_LOW error when the device camera cannot meet that requirement.

Migration Guides

When migrating from old version to this version, you need to:

Add the aai-specs pod spec source and change the dependency version

source 'https://cdn.cocoapods.org/'
source 'https://github.com/advance-ai-mobile/aai-specs'

pod 'AAILivenessSDK', '4.2.0' # This module automatically fetches AAICore(1.0.4) and AAINetwork(1.1.0).
pod 'AAILivenessUI', '4.2.0' 
pod 'AAILivenessModel', '4.2.0'
pod 'AAIDataVisorSDK', '0.1.7'

Then run pod install --repo-update.

v4.1.2 (2025.12.01) Download

Bug Fixes

Fix the issue where endRequestBlk wasn't called after restartDetection() was invoked.
Fix the issue where livenessStageChangedBlk wasn't called during distant/near stage transitions
Fix crash caused by "[__NSPlaceholderDictionary initWithObjects:forKeys:count:]: attempt to insert nil object from objects[0]"

Update

Enhance jailbreak detection

Migration Guides

When migrating from older version to this version, you need to:

Add the aai-specs pod spec source and change the dependency version:

source 'https://cdn.cocoapods.org/'
source 'https://github.com/advance-ai-mobile/aai-specs'

pod 'AAILivenessUI', '4.1.2' # This module automatically fetches AAICore(1.0.2) and AAINetwork(1.0.4).
pod 'AAILivenessModel', '4.0.0'
pod 'AAIDataVisorSDK', '0.1.7'

Then run pod install --repo-update.

v4.1.1 (2025.09.09) Download

Bug Fixes

Fixed an internal logic error related to audit images.

Update

Set the default imageMaxNumber of audit images to 10, and the default value of imageCaptureInterval to 500ms.

Migration Guides

When migrating from version 4.1.0 to this version, you need to:

Change the download link of SDK module to the following value:

pod 'AAILivenessUI', :http => 'https://prod-guardian-cv.oss-ap-southeast-5.aliyuncs.com/sdk/iOS-liveness-detection/4.1.1/iOS-Liveness-SDK-V4.1.1.tar.bz2', type: :tbz 

pod 'AAILivenessModel', :http => 'https://prod-guardian-cv.oss-ap-southeast-5.aliyuncs.com/sdk/iOS-libraries/AAILivenessModel/4.0.0/AAILivenessModel-V4.0.0.tar.bz2', type: :tbz 

pod 'AAICore', :http => 'https://prod-guardian-cv.oss-ap-southeast-5.aliyuncs.com/sdk/iOS-libraries/AAICore/1.0.1/AAICore-V1.0.1.tar.bz2', type: :tbz 

pod 'AAINetwork', :http => 'https://prod-guardian-cv.oss-ap-southeast-5.aliyuncs.com/sdk/iOS-libraries/AAINetwork/AAINetwork-V1.0.4.tar.bz2', type: :tbz 

pod 'AAIDataVisorSDK', :http => 'https://prod-guardian-cv.oss-ap-southeast-5.aliyuncs.com/sdk/iOS-AAIDataVisor-SDK/0.1.5/iOS-AAIDataVisorSDK-V0.1.5.tar.bz2', type: :tbz

Then run pod install.

v4.1.0 (2025.08.12) Download

Breaking Changes

Introduced the new initialization method initWithConfig:(id<AAILDInitConfig>)config to replace the previous init methods. The following init methods have been removed:

/*
// The following init method has been removed and replaced by the new method 'initWithConfig:(id<AAILDInitConfig>)config'
+ (void)initWithMarket:(AAILivenessMarket)market;
+ (void)initWithMarket:(AAILivenessMarket)market isGlobalService:(BOOL)isGlobalService;
+ (void)initWithAccessKey:(NSString *)accesskey secretKey:(NSString *)secretkey market:(AAILivenessMarket)market;
+ (void)initWithAccessKey:(NSString *)accesskey secretKey:(NSString *)secretkey market:(AAILivenessMarket)market isGlobalService:(BOOL)isGlobalService;
*/

Example usage for the new initialization:

// Case 1. License Initialization:
let licenseConfig = AAILDLicenseModeConfig()
// Set your market
licenseConfig.market = .indonesia
// Set whether the SDK is used as a global service
licenseConfig.isGlobalService = false
AAILivenessSDK.initWith(licenseConfig)

// Case 2. Static Key Initialization:
let staticKeyConfig = AAILDStaticKeyModeConfig()
staticKeyConfig.accessKey = "your-accessKey"
staticKeyConfig.secretKey = "your-secretKey"
// Set your market
staticKeyConfig.market = .indonesia
 // Set whether the SDK is used as a global service
staticKeyConfig.isGlobalService = false
AAILivenessSDK.initWith(staticKeyConfig)

// Case 3. Ticket Initialization:
let ticketConfig = AAILDTicketModeConfig()
// Set your market
ticketConfig.market = .indonesia
// Set whether the SDK is used as a global service
ticketConfig.isGlobalService = false
AAILivenessSDK.initWith(ticketConfig)

Update

Optimized to reduce the occurrence of the CAMERA_OPEN_FAILED issue.
Enhanced the stability of the injection checking mechanism.
Introduced the new dependency AAIDataVisorSDK to enhance fraud detection capabilities.

Migration Guides

When migrating from version 4.0.0 to this version, you need to:

Change the download link of SDK module to the following value:

pod 'AAILivenessUI', :http => 'https://prod-guardian-cv.oss-ap-southeast-5.aliyuncs.com/sdk/iOS-liveness-detection/4.1.0/iOS-Liveness-SDK-V4.1.0.tar.bz2', type: :tbz

pod 'AAILivenessModel', :http => 'https://prod-guardian-cv.oss-ap-southeast-5.aliyuncs.com/sdk/iOS-libraries/AAILivenessModel/4.0.0/AAILivenessModel-V4.0.0.tar.bz2', type: :tbz

pod 'AAICore', :http => 'https://prod-guardian-cv.oss-ap-southeast-5.aliyuncs.com/sdk/iOS-libraries/AAICore/1.0.1/AAICore-V1.0.1.tar.bz2', type: :tbz

pod 'AAINetwork', :http => 'https://prod-guardian-cv.oss-ap-southeast-5.aliyuncs.com/sdk/iOS-libraries/AAINetwork/AAINetwork-V1.0.4.tar.bz2', type: :tbz

pod 'AAIDataVisorSDK', :http => 'https://prod-guardian-cv.oss-ap-southeast-5.aliyuncs.com/sdk/iOS-AAIDataVisor-SDK/0.1.5/iOS-AAIDataVisorSDK-V0.1.5.tar.bz2', type: :tb

Then run pod install.
Please refer the breaking changes above to adjust your code for version 4.1.0.

v4.0.0 (2025.06.19) Download

New Feature

New Product Levels: Added Standard and Pro Levels for Liveness Detection to meet different customer needs;
Comprehensive Method Integration: Support silent, action, distantNear, distantNear+action liveness detection methods;
Flexible Scene Adaptation: Support custom scene naming and mapping to liveness detection methods for scenarios like user login and loans, with no need for additional integration when changing methods;
Dynamic Model File Distribution: Support dynamic model file distribution reduces package size and accelerates updates.

Migration Guides

When migrating from older version to this version, you need to:

Change the download link of SDK module to the following value:

pod 'AAINetwork', :http => 'https://prod-guardian-cv.oss-ap-southeast-5.aliyuncs.com/sdk/iOS-libraries/AAINetwork/AAINetwork-V1.0.4.tar.bz2', type: :tbz 

pod 'AAILivenessUI', :http => 'https://prod-guardian-cv.oss-ap-southeast-5.aliyuncs.com/sdk/iOS-liveness-detection/4.0.0/iOS-Liveness-SDK-V4.0.0.tar.bz2', type: :tbz

pod 'AAILivenessModel', :http => 'https://prod-guardian-cv.oss-ap-southeast-5.aliyuncs.com/sdk/iOS-libraries/AAILivenessModel/4.0.0/AAILivenessModel-V4.0.0.tar.bz2', type: :tbz

pod 'AAICore', :http => 'https://prod-guardian-cv.oss-ap-southeast-5.aliyuncs.com/sdk/iOS-libraries/AAICore/1.0.0/AAICore-V1.0.0.tar.bz2', type: :tbz

Then run pod install.
Please refer to the Migration Guide to adjust your code for version 4.0.0.