Face Recognition, Liveness Detection, Pose Estimation Android SDK Demo

Latest NIST FRVT Report

Recognito Developer News

• Global Coverage ID Card/Passport OCR Mobile Demo and ID Document Recognition Server Demo.
• Try 1:N Face Search through our Face Identification Web Demo.
• Subscribe our Free APIs for your app or website from our API Hub.

This repository contains a demonstration of Recognito's face recognition SDK for Android. The SDK includes advanced features such as face recognition, liveness detection, and pose estimation. Recognito's face recognition algorithm has been ranked as the Top 1 in the NIST FRVT (Face Recognition Vendor Test).

Our Product List for ID verification.

RECOGNITO Product Documentation

  

Features

• Face Recognition: Identify and verify individuals by comparing their facial features.
• Liveness Detection: Determine whether a face is live or spoofed to prevent fraud in authentication processes.
• Pose Estimation: Estimate the pose of a detected face, including Yaw, Roll, Pitch

- Additional Features

• NIST FRVT Top 1 Algorithm: Utilize the top-ranked face recognition algorithm from the NIST FRVT for accurate and reliable results.
• On-premise: Operate entirely within your infrastructure, ensuring data privacy and security.
• Real-time: Perform face recognition, liveness detection, and pose estimation with minimal latency.
• Fully-offline: Function without the need for an internet connection, ensuring reliability and data privacy.

Demo Video

Recognito Youtube Channel: youtube.com/@recognito-vision

Download APK

SDK Integration

To use the Recognito SDK in your Android project, follow these steps:

1. Add libfacesdk into the project

• Add the SDK folder to your Android project's directory.

• Add the following dependency to your build.gradle and settings.gradle files:

  Android-FaceRecognition-FaceLivenessDetection/app/build.gradle

  Lines 50 to 52 in 601379c

  	implementation project(path: ':libfacesdk')

  Android-FaceRecognition-FaceLivenessDetection/settings.gradle

  Lines 17 to 19 in 601379c

  	rootProject.name = "FaceRecognition"
  	include ':app'
  	include ':libfacesdk'

2. Application License (One-Time License)

• For trial license, share your application ID.

  Android-FaceRecognition-FaceLivenessDetection/app/build.gradle

  Lines 6 to 15 in 601379c

  	android {
  	namespace 'com.bio.facerecognition'
  	compileSdk 33
  	defaultConfig {
  	applicationId "com.bio.facerecognition"
  	minSdk 24
  	targetSdk 33
  	versionCode 4
  	versionName "1.3"

                

• Add your license to assets/license file:

  Android-FaceRecognition-FaceLivenessDetection/app/src/main/assets/license

  Lines 1 to 5 in 601379c

  	BsTr9o4f4R/rM3TxbCWVb/hrOJuOIdz8ArQ/t2IgQFFUQzGHOLNNaMJiK/fUfr5zo005zoTA/cm6
  	VoZ6iGl+/hZGA3R5T/VWwhxekbw8JVz9sNesU6rMG5+1cNSN75trH2tpzdCPZ28ZDnZlttmiuUoC
  	9QazRe1xKi5tUXa+xgIxzL0vE6UW2dLKWaEXjn3fSJfLxXWw0q+UZP0hQAXb5Y9Yl/NVi7y3d0xT
  	Vq6/weuMQkgLcNdLqFRvQXup0M9W/pvuhaubySAxHCKVY8wToygN2iM78cOkyyAbGVwZeGQP0Jfd
  	46VZo+w+KCNw355j3osVVMghrOcVZnfbp1dNyg==

• Initialize SDK with license.

  Android-FaceRecognition-FaceLivenessDetection/app/src/main/java/com/bio/facerecognition/MainActivity.kt

  Lines 39 to 47 in 601379c

  	val license_str = application.assets.open("license").bufferedReader().use{
  	it.readText()
  	}
  	var ret = FaceSDK.setActivation(license_str)
  	if (ret == FaceSDK.SDK_SUCCESS) {
  	ret = FaceSDK.init(assets)
  	}

  Initialization status codes:

  Code	Status
  0	Activate SDK successfully
  -1	License Key Error
  -2	License AppID Error
  -3	License Expired
  -4	Activate Error
  -5	Init SDK Error

3. APIs of SDK

- Activate SDK

public static native int setActivation(String var0);

Parameters

• var0: The license string.
• Return Value: An integer representing the SDK activation status code.

- Initiate SDK

public static native int init(AssetManager var0);

Parameters

• var0: An instance of AssetManager used to access application assets.
• Return Value: An integer representing the initialization status code.

- Convert YUV camera frame to Bitmap image

public static native Bitmap yuv2Bitmap(byte[] nv21, int width, int height, int orientation);

Parameters

• nv21: Byte array representing the YUV image data in NV21 format.

• width: Width of the image.

• height: Height of the image.

• orientation: Orientation of the image

  Value	Orientation
  1	No processing
  2	Flip horizontally
  3	Flip horizontally first and then flip vertically
  4	vertical flip
  5	transpose
  6	Rotate 90° clockwise
  7	Horizontal and vertical flip --> transpose
  8	Rotate 90° counterclockwise

• Return Value: A Bitmap object representing the converted image.

- Detect Face

public static native List<FaceBox> faceDetection(Bitmap var0, FaceDetectionParam var1);

Parameters

• var0: The Bitmap image.
• var1: Parameters for face detection

public class FaceDetectionParam {
    public boolean check_liveness = false;
    public int check_liveness_level = 0; // 0: more accurate model, 1: lighter model
}

• Return Value: A list of FaceBox objects representing the detected faces.

public class FaceBox {
    public int x1;
    public int y1;
    public int x2;
    public int y2;
    public float liveness;
    public float yaw;
    public float roll;
    public float pitch;
}

- Extract face feature

public static native byte[] templateExtraction(Bitmap var0, FaceBox var1);

Parameters

• var0: The Bitmap image
• var1: The bounding box (FaceBox) of the detected face.
• Return Value: A byte array representing the extracted template from the face.

- Calculate similarity between two face features

public static native float similarityCalculation(byte[] var0, byte[] var1);

Parameters

• var0: The byte array representing the first face template.
• var1: The byte array representing the second face template.
• Return Value: A float value representing the similarity score between the two face templates.

Support

For any questions, issues, or feature requests, please contact our support team.