iOS liveness detection SDK change logs and release history

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:

  1. 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'
     

  2. 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:

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

  2. 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:

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

     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
     

  2. Then run pod install.

  3. 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:

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

  2. Then run pod install.

  3. Please refer to the Migration Guide to adjust your code for version 4.0.0.

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