change-logs

iOS liveness detection SDK change logs and release history

v4.1.3 (2025.12.29) Download

Update

Introduced a new error code INTERRUPTED_BY_ANOTHER_CLIENT to indicate that the camera has been preempted by another application. If this error occurs, you can call livenessVC.restartDetection() to restart detection.

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


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

pod 'AAILivenessUI', '4.1.3' # This module automatically fetches AAICore(1.0.2) and AAINetwork(1.1.0).
pod 'AAILivenessModel', '4.0.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 old version to this version, you need to:

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


xxxxxxxxxx
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:


xxxxxxxxxx
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:


xxxxxxxxxx
/*
// 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:


xxxxxxxxxx
 // 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:


xxxxxxxxxx
pod 'AAILivenessSDK', :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 '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:


xxxxxxxxxx
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.

iOS liveness detection SDK change logs and release history

v4.1.3 (2025.12.29) Download

Update

Migration Guides

v4.1.2 (2025.12.01) Download

Bug Fixes

Update

Migration Guides

v4.1.1 (2025.09.09) Download

Bug Fixes

Update

Migration Guides

v4.1.0 (2025.08.12) Download

Breaking Changes

Update

Migration Guides

v4.0.0 (2025.06.19) Download

New Feature

Migration Guides

For older liveness detection change logs and release history, see here.