A Flutter plugin for FaceAISDK — on-device face verification, liveness detection, and face enrollment for Android and iOS.

Bahasa Indonesia

• Face Enrollment — Register a face for 1:1 verification
• Face Verification (1:1) — Verify a live face against a stored face
• Liveness Detection — Anti-spoofing detection (motion, color flash, silent)
• Add Face — Add a face to the search database

All processing is on-device. No internet required.

Add extractNativeLibs="true" to your <application> tag:

<application
    android:extractNativeLibs="true"
    ...>

Add these configurations to android/app/build.gradle.kts:

android {
    // Java 17 required
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_17
        targetCompatibility = JavaVersion.VERSION_17
    }
    kotlinOptions {
        jvmTarget = "17"
    }

    // Sign with FaceAISDK-registered keystore
    signingConfigs {
        create("faceai") {
            storeFile = file("your-keystore-file")
            storePassword = "your-password"
            keyAlias = "your-alias"
            keyPassword = "your-password"
        }
    }
    buildTypes {
        debug {
            signingConfig = signingConfigs.getByName("faceai")
        }
        release {
            signingConfig = signingConfigs.getByName("faceai")
        }
    }
}

FaceAISDK validates the app's package name + signing certificate. You must register your signing key with the SDK provider:

• Contact: FaceAISDK.Service@gmail.com
• GitHub: https://github.com/FaceAISDK/FaceAISDK_Android

For development/testing, you can use the demo keystore (FaceAIPublic) with applicationId = "com.ai.face.Demo".

Set the platform to iOS 15.5+ and add the FaceAISDK_Core pod in your ios/Podfile:

platform :ios, '15.5'

target 'Runner' do
  use_frameworks!

  flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__))

  pod 'FaceAISDK_Core', :git => 'https://github.com/FaceAISDK/FaceAISDK_Core.git', :tag => '2026.03.27'
end

Add this post_install block to fix BUILD_LIBRARY_FOR_DISTRIBUTION ABI mismatch:

post_install do |installer|
  installer.pods_project.targets.each do |target|
    flutter_additional_ios_build_settings(target)

    target.build_configurations.each do |config|
      config.build_settings['BUILD_LIBRARY_FOR_DISTRIBUTION'] = 'YES'
      config.build_settings['OTHER_SWIFT_FLAGS'] ||= '$(inherited)'
      config.build_settings['OTHER_SWIFT_FLAGS'] += ' -Xfrontend -enable-library-evolution'
    end
  end
end

Then run:

cd ios && pod install

Add camera permission to ios/Runner/Info.plist:

<key>NSCameraUsageDescription</key>
<string>Camera access is required for face verification and liveness detection.</string>

The plugin requires a physical device — simulator builds are not supported (EXCLUDED_ARCHS[sdk=iphonesimulator*] excludes i386 and arm64).

Must be called before any other method:

final faceAiSdk = FaceAiSdk();
await faceAiSdk.initializeSDK({
  'locale': 'en',  // iOS only: UI language — "en" (default), "id", "zh-Hans"
});

Capture and register a face for 1:1 verification:

final result = await faceAiSdk.startEnroll(
  faceId: "user_123",
  format: "base64",  // or "filePath"
);

if (result['code'] == 1) {
  print('Enrolled: ${result['faceID']}');
}

Compare a live face against a stored face:

final result = await faceAiSdk.startVerification(
  faceId: "user_123",        // face ID for stored lookup (faceId or faceFeature required)
  faceFeature: null,          // or pass face feature string directly
  threshold: 0.85,            // 0.75 - 0.95
  livenessType: 1,            // 0=NONE, 1=MOTION, 2=MOTION+COLOR, 3=COLOR, 4=SILENT
  motionStepSize: 1,          // 1-2 steps
  motionTimeout: 10,          // 3-22 seconds
  motionTypes: "1,2,3",       // 1=mouth, 2=smile, 3=blink, 4=shake, 5=nod
  allowRetry: true,           // allow retry on timeout/failure
  format: "base64",           // "base64" or "filePath"
);

if (result['code'] == 1) {
  print('Match! Similarity: ${result['similarity']}');
  print('Liveness: ${result['livenessValue']}');
}

Detect if the face is a real person (no face matching):

final result = await faceAiSdk.startLiveness(
  livenessType: 1,          // 1=MOTION, 2=MOTION+COLOR, 3=COLOR, 4=SILENT
  motionStepSize: 1,
  motionTimeout: 10,
  motionTypes: "1,2,3",
  format: "base64",
);

if (result['code'] == 10) {
  print('Liveness score: ${result['livenessValue']}');
}

Add a face for 1:N search:

final result = await faceAiSdk.addFace(
  faceId: "user_456",
  format: "base64",
);

if (result['code'] == 1) {
  print('Face added: ${result['faceID']}');
}

Comma-separated string of motion IDs:

The SDK validates your app's package name + signing certificate. If they don't match the registered values, the native code crashes. Make sure:

1. Your applicationId is registered with FaceAISDK
2. Your signing keystore is registered with FaceAISDK
3. android:extractNativeLibs="true" is set in AndroidManifest.xml

Ensure camera permission is granted at runtime. The plugin declares <uses-permission android:name="android.permission.CAMERA" /> automatically on Android. On iOS, add NSCameraUsageDescription to Info.plist.

FaceAISDK_Core is a pre-compiled binary. All pods must use a consistent BUILD_LIBRARY_FOR_DISTRIBUTION setting. Add the post_install block from the iOS Setup section to your Podfile.

Make sure you added the FaceAISDK_Core pod to your Podfile and ran pod install. The module is not available on CocoaPods trunk — it must be referenced via the Git URL.

See LICENSE for details.

• FaceAISDK Android — Core face AI engine (Android)
• FaceAISDK_Core — Core face AI engine (iOS)