iOS liveness detection SDK change logs and release history

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:

     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
     

  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:

  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:

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

  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

1. New Product Levels: Added Standard and Pro Levels for Liveness Detection to meet different customer needs;
2. Comprehensive Method Integration: Support silent, action, distantNear, distantNear+action liveness detection methods;
3. 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;
4. 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:

     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
     

  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.