Skip to content

About

On-device face recognition, liveness detection, and facial attribute analysis (age, gender, emotion) SDK for Android — FaceOnLive

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

FaceOnLive — Face Recognition, Liveness & Attribute SDK for Android

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.

Features

  • 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.

Requirements

Min Android SDK 24 (Android 7.0)
Compile / Target SDK 34
Language Kotlin / Java
Permissions CAMERA

Setup

  1. Open the project in Android Studio.
  2. Get a license key — free trial at https://faceonlive.com.
  3. This demo reads the key from app/src/main/assets/license. Replace the <YOUR_LICENSE_KEY> placeholder in that file with your key.
  4. Build and run on a device.

Quick start

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

API reference

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.

License & support

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

📦 Full SDK download

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.

About

On-device face recognition, liveness detection, and facial attribute analysis (age, gender, emotion) SDK for Android — FaceOnLive

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages