DOT Android Face 7.0.0

This guide describes how to migrate DOT Android Face version 6.x to version 7.0. Only the most important changes are highlighted in this guide. For more details, see the Android Samples.

Migration Steps (Kotlin)#

Compatibility with DIS#

When utilizing DIS for server-side evaluation, ensure compatibility between your DIS version and the corresponding SDK version. Refer to the DIS vs SDKs compatibility table for detailed compatibility information.

Basic Setup#

• Replace DotFaceLibrary.initializeAsync() with DotSdk.initialize(). This operation should be called on background thread. DOT Android SDK Samples shows how to do it.
• Replace DotFaceLibrary.deinitializeAsync() with DotSdk.deinitialize().
• Replace DotFaceLibrary.isInitialized() with DotSdk.isInitialized().

Before#

// Initialize DOT Face Library
fun initialize(context: Context, onFinished: (DotFaceLibrary.Result) -> Unit) {
  val license = readLicenseBytes(context.resources)
  val modules = createDotFaceLibraryModules()
  val configuration = DotFaceLibraryConfiguration.Builder(context, license, modules).build()
  DotFaceLibrary.initializeAsync(configuration, onFinished)
}

private fun createDotFaceLibraryModules() = listOf(
  DotFaceDetectionFastModule.of(),
  DotFaceVerificationModule.of(),
  DotFacePassiveLivenessModule.of(),
)

// Deinitialize
DotFaceLibrary.deinitializeAsync(onFinished)

// Check if the DOT Face Library is initialized
val isDotFaceLibraryInitialized = DotFaceLibrary.isInitialized()

After#

// Initialize DOT SDK (including DOT Face Library)
fun initialize(context: Context) {
  val configuration = createDotSdkConfiguration(context)
  DotSdk.initialize(configuration)
}

private fun createDotSdkConfiguration(context: Context) = DotSdkConfiguration(
  context = context,
  licenseBytes = readLicenseBytes(context.resources),
  libraries = listOf(
    createDotFaceLibrary(),
  ),
)

private fun createDotFaceLibrary(): DotFaceLibrary {
  val modules = createDotFaceLibraryModules()
  val configuration = DotFaceLibraryConfiguration(modules)
  return DotFaceLibrary(configuration)
}

private fun createDotFaceLibraryModules() = listOf(
  DotFaceDetectionFastModule.of(),
  DotFaceVerificationModule.of(),
  DotFacePassiveLivenessModule.of(),
)

// Deinitialize
DotSdk.deinitialize()

// Check if the DOT SDK is initialized
val isDotSdkInitialized = DotSdk.isInitialized()