On-device face detection, face liveness (anti-spoofing), 1:1 / 1:N face matching, and facial attribute analysis (age, gender, emotion, and more) for Android. All processing runs locally.
Part of the FaceOnLive on-premises biometric SDK suite.
- Face detection with landmarks and a liveness score.
- Face template extraction and similarity comparison.
- Facial attributes: age, gender, and expression estimation.
- Fully on-device and offline.
| Min Android SDK | 24 (Android 7.0) |
| Compile / Target SDK | 34 |
| Language | Kotlin / Java |
| Permissions | CAMERA |
- Open the project in Android Studio.
- Get a license key — free trial at https://faceonlive.com.
- This demo reads the key from
app/src/main/assets/license. Replace the<YOUR_LICENSE_KEY>placeholder in that file with your key. - Build and run on a device.
import com.bio.facesdk.FaceSDK
val license = assets.open("license").bufferedReader().use { it.readText() }
if (FaceSDK.setActivation(license) == FaceSDK.SDK_SUCCESS) {
FaceSDK.init(assets)
}
val faces = FaceSDK.faceDetection(bitmap) // includes liveness + attributes| Method | Description | Returns |
|---|---|---|
setActivation(license) |
Activate with your license key. | SDK_SUCCESS or error |
init(assets) |
Load the face + attribute models. | SDK_SUCCESS or error |
faceDetection(bitmap) |
Detect faces with landmarks, liveness score, and attributes. | list of faces |
templateExtraction(bitmap, face) |
Extract a face's feature template. | template |
similarityCalculation(t1, t2) |
Compare two templates. | 0.0–1.0 |
Status codes: SDK_SUCCESS, SDK_LICENSE_KEY_ERROR, SDK_LICENSE_APPID_ERROR, SDK_LICENSE_EXPIRED, SDK_NO_ACTIVATED, SDK_INIT_ERROR.
Requires a valid license key — get one at faceonlive.com. Never commit your key or the license asset with a real key. Questions: contact@faceonlive.com
This repository contains the source/demo code only. Download the complete SDK — engine libraries and models, with full project structure — from the Releases page and extract it over this project.