blusalt_liveness_native

Description:

blusalt liveness native

blusalt_liveness_native #
Facial Comparison and Face Detection SDK for Android and IOS
Get your Liveness credentials from Blusalt
Features #
Facial comparison (LivenessFacialComparisonType)

Dynamic Liveness Detection (Motional):
This method verifies liveness by requiring the user to perform specific actions like opening their mouth or shaking their head.
It's strict because attempts to bypass the action (like holding a still image) will be detected and likely terminate the process.
Static Liveness Detection (Still):
This approach asks users to position their face within the camera frame and validates liveness based on facial data points.
It's less strict than the dynamic method. If users struggle with finding the right camera position, the process might not automatically terminate, allowing them to adjust.

Face Detection (LivenessDetectionOnlyType)

Dynamic Liveness Detection (Motional)
Static Liveness Detection (Still)
Flash Liveness Detection (Flash):
This method is only available for facial detection, not facial comparison.
It works similarly to the static method but increases the device screen brightness to enhance facial data point detection.

Usage #
dependencies:
blusalt_liveness_native: ^lastVersion
copied to clipboard
Example #
///[thresholdInPercent] ranges between 0-100. The higher the value, the stricter the facial comparison.
///When set to null or no value is passed, it will use the default value from SDK which ranges from 90-94.
///
///[timeoutDurationInSec] this value can be used top override the timeout duration of networks calls in the SDK.
///When set to null or no value is passed, it will use the default value from SDK 120s.
///
/// [startProcessOnGettingToFirstScreen] starts the SDK on getting to the SDK homepage
/// rather than making user click continue button.
startFacialComparisonSDK() async {
BlusaltLivenessResultResponse? response =
await _livenessPlugin.startFacialComparisonSDK(
apiKey: apiKey,
appName: appName,
clientId: clientId,
isDev: isDev,
livenessFacialComparisonType:
LivenessFacialComparisonType.motional,
startProcessOnGettingToFirstScreen: true,
thresholdInPercent: null,
timeoutDuration: null);
}

startLivenessDetectionOnlySDK() async {
BlusaltLivenessResultResponse? response =
await _livenessPlugin.startLivenessDetectionOnlySDK(
apiKey: apiKey,
appName: appName,
clientId: clientId,
isDev: isDev,
livenessDetectionOnlyType:
LivenessDetectionOnlyType.still,
startProcessOnGettingToFirstScreen: true,
timeoutDuration: null);
}

copied to clipboard
Installation #
Android #
Step 1
Create a [github.properties] file in root of android folder and put below into content.
Replace values with your github credentials from github and make sure to grant necessary permissions especially for github packages
USERNAME_GITHUB=SampleUsername
TOKEN_GITHUB=SampleClassicToken
copied to clipboard
Step 2
Add below to project level gradle file /android/build.gradle
buildscript {
ext.kotlin_version = '1.9.+'
...

dependencies {
classpath 'com.android.tools.build:gradle:7.3.+'
classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
}
}

allprojects {
def githubPropertiesFile = rootProject.file("github.properties")
def githubProperties = new Properties()
githubProperties.load(new FileInputStream(githubPropertiesFile))


repositories {

maven {
name "GitHubPackages"
url 'https://maven.pkg.github.com/Blusalt-FS/Liveness-Only-Android-Package'

credentials {
username githubProperties['USERNAME_GITHUB']
password githubProperties['TOKEN_GITHUB']
}
}
}
}
copied to clipboard
Step 3
Change the minimum Android sdk version to 24 (or higher) in your /android/app/build.gradle file.

android {
...
defaultConfig {
...
minSdkVersion 24
}
...
}
copied to clipboard
Step 4
If you're experiencing crashes or timeouts.
Add below to your progaurd.pro file if using progaurd or minify is enabled /android/app/proguard-rules.pro
-keep public class com.megvii.**{*;}
-keep class net.blusalt.liveness_native.** { *; }
copied to clipboard
Enable proguard in /android/app/build.gradle file like below.

android {

...
buildTypes {
release {
minifyEnabled true
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
}
}
...
}
copied to clipboard
Note on Android: #
If you are getting an error on android which says "Unauthorized" when gradle is downloading or
building, generate a new
github token that have access to clone, read and write to repo, access github packages. If you don't
know which to tick, tick all boxes. Cheers
iOS #
Minimum iOS Deployment = 14
copied to clipboard
Add one row to the ios/Runner/Info.plist:
with the key Privacy - Camera Usage Description and a usage description.
<key>NSCameraUsageDescription</key>
<string>your usage description here</string>
copied to clipboard
Note on iOS #

This Plugin will only work properly on a physical ios device, iOS Simulators are not supported.
If you get an error while compiling about MediaPlayer or Webkit missing. On xcode, click on
Runner, under TARGETS, click Runner, Under General Tab, scroll down
to Frameworks, Libraries and Embedded Contents, Click the + icon, search and add each of
frameworks
AVFoundation.framework, CoreMedia.framework, CoreMotion.framework, MediaPlayer.framework,
SystemConfiguration.framework, WebKit.framework