Our facial recognition algorithm is globally top-ranked by NIST in the FRVT 1:1 leaderboards.

Latest NIST FRVT evaluation report 2024-12-20

🆔 ID Document Liveness Detection - Linux - Here

🤗 Hugging Face - Here

📚 Product & Resources - Here

🛟 Help Center - Here

💼 KYC Verification Demo - Here

🙋‍♀️ Docker Hub - Here

FaceActiveLivenessDetection-Android

Overview

This repository showcases real-time Face Active Liveness Detection technology on Android device. Active face liveness detection is a security measure used in biometric systems to confirm that a live person, rather than a fraudulent representation like a photo or mask, is present during authentication. This method requires users to perform specific actions in real-time, such as blinking, smiling, or turning their head, to demonstrate liveness. By analyzing these prompted movements, the system can effectively distinguish between genuine users and potential spoofing attempts.

In this repository, we implemented face active liveness detection by integrating KBY-AI's Face SDK premium package into Android project.

◾FaceSDK(Mobile) Product List

No.	Repository	SDK Details
1	Face Liveness Detection - Android	Basic SDK
2	Face Liveness Detection - iOS	Basic SDK
3	Face Recognition + Face Liveness Detection - Android	Standard SDK
4	Face Recognition + Face Liveness Detection - iOS	Standard SDK
5	Face Recognition + Face Liveness Detection - Flutter	Standard SDK
6	Face Recognition + Face Liveness Detection - Ionic-Cordova	Standard SDK
7	Face Recognition + Face Liveness Detection - React-Native	Standard SDK
8	Face Attribute - Android	Premium SDK
9	Face Attribute - iOS	Premium SDK
10	Face Attribute - Flutter	Premium SDK
➡️	Face Active Liveness Detection - Android	Premium SDK

To get Face SDK(server), please visit products here.

Try the APK

Google Play

Performance Video

You can visit our YouTube video here to see how well our demo app works.

SDK License

This repository requires a license per application ID to run on Android.

• The code below shows how to use the license:

  FaceActiveLivenessDetection-Android/app/src/main/java/com/kbyai/faceattribute/MainActivity.kt

  Lines 33 to 39 in e97e35a

  	var ret = FaceSDK.setActivation(
  	"DYv3mu71v8b9hqraZETNpg+CdriRbg1qLLMbfNqTeGdvSdbGPGudJpiVR4Tl9TEcJrZrZG+59ay6\n" +
  	"BtL78C1VsDGsOzSKw9ssETgVnT9DIc/LdNrqs4/o7o3nO0ZPz3iNu/P2jKkUXLo/uzh+aaVLbi55\n" +
  	"X9NQYhD5EHFqL2mLtGxcfqccTHLMW0MIe0Wq65hzPIrR6oh7tvtKzX5EcOOPv8UK2a3i9+MgtG4Y\n" +
  	"b+CHoQ0lNJhmZkpdKmcRidibJLKgwJqDPiZfwsW6C3hcrNNo6T8T+NMZ4W7rHcQKfdSr0yXtYqCr\n" +
  	"kaMKrGzlk8nYubwfqZGeAKSyjuL8mWWgY57I3Q=="
  	)

• To request a license, please contact us:
  🧙Email: contact@kby-ai.com
  🧙Telegram: @kbyaisupport
  🧙WhatsApp: +19092802609
  🧙Discord: KBY-AI
  🧙Teams: KBY-AI
  

About SDK

Set up

1. Copy the SDK (libfacesdk folder) to the root folder in your project.

2. Add SDK to the project in settings.gradle.

include ':libfacesdk'

3. Add dependency to your build.gradle.

implementation project(path: ':libfacesdk')

Initializing an SDK

• Step One

To begin, you need to activate the SDK using the license that you have received.

FaceSDK.setActivation("...")

If activation is successful, the return value will be SDK_SUCCESS. Otherwise, an error value will be returned.

• Step Two

After activation, call the SDK's initialization function.

FaceSDK.init(getAssets());

If initialization is successful, the return value will be SDK_SUCCESS. Otherwise, an error value will be returned.

Face Detection and Liveness Detection

The FaceSDK offers a single function for detecting face and liveness detection, which can be used as follows:

FaceSDK.faceDetection(bitmap)

This function takes a single parameter, which is a bitmap object. The return value of the function is a list of FaceBox objects. Each FaceBox object contains the detected face rectangle, liveness score, and facial angles such as yaw, roll, and pitch.

Yuv to Bitmap

The SDK provides a function called yuv2Bitmap, which converts a yuv frame to a bitmap. Since camera frames are typically in yuv format, this function is necessary to convert them to bitmap. The usage of this function is as follows:

Bitmap bitmap = FaceSDK.yuv2Bitmap(nv21, image.getWidth(), image.getHeight(), 7);

The first parameter is an nv21 byte array containing the yuv data.

The second parameter is the width of the yuv frame, and the third parameter is its height.

The fourth parameter is the conversion mode, which is determined by the camera orientation.

To determine the appropriate conversion mode, the following method can be used:

 1        2       3      4         5            6           7          8

 888888  888888      88  88      8888888888  88                  88  8888888888
 88          88      88  88      88  88      88  88          88  88      88  88
 8888      8888    8888  8888    88          8888888888  8888888888          88
 88          88      88  88
 88          88  888888  888888