Release Notes

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

     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:

  Objective-C

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

  Swift

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

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

     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.