> For the complete documentation index, see [llms.txt](https://docs.recognito.vision/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.recognito.vision/face-liveness-detection-sdk/integration-guide/android/sample-application.md).

# Sample Application

{% embed url="<https://www.youtube.com/watch?v=9HM70PFa4lQ>" %}
NIST FRVT #1 Face Recognition, Liveness Detection Mobile SDK Demo
{% endembed %}

***

### Download APK

<table data-view="cards" data-full-width="false"><thead><tr><th></th><th data-hidden></th><th data-hidden></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>Recognito_FaceDemo_Core.apk</td><td></td><td></td><td><a href="/files/3o0HeYVavQGPi0XBmvWy">/files/3o0HeYVavQGPi0XBmvWy</a></td><td><a href="https://www.dropbox.com/scl/fi/w11b9wl80tqo9mf9op33f/Recognito_FaceDemo_Core.apk?rlkey=ne9r67ixan6xk4luau9eucj7g&#x26;st=mvp9c5gd&#x26;dl=0">https://www.dropbox.com/scl/fi/w11b9wl80tqo9mf9op33f/Recognito_FaceDemo_Core.apk?rlkey=ne9r67ixan6xk4luau9eucj7g&#x26;st=mvp9c5gd&#x26;dl=0</a></td></tr><tr><td>Recognito_FaceDemo_Pro.apk</td><td></td><td></td><td><a href="/files/3o0HeYVavQGPi0XBmvWy">/files/3o0HeYVavQGPi0XBmvWy</a></td><td><a href="https://www.dropbox.com/scl/fi/n8eqf1y6ah021n38s3gvv/Recognito_FaceDemo_Pro.apk?rlkey=1mfhdcb23l788jo1v4t5kazno&#x26;st=ls235b8z&#x26;dl=0">https://www.dropbox.com/scl/fi/n8eqf1y6ah021n38s3gvv/Recognito_FaceDemo_Pro.apk?rlkey=1mfhdcb23l788jo1v4t5kazno&#x26;st=ls235b8z&#x26;dl=0</a></td></tr></tbody></table>

***

## Build Project

### - Download and Open Project

* Download&#x20;
  * [**Recognito\_Face\_Android\_Core.zip\[33.6M\]**](https://www.dropbox.com/scl/fi/jqku6qlfwkdavq808wycv/Recognito_Face_Android_Core.zip?rlkey=z5pfxpt094qhjhwq7mbia3r57\&st=gv2v5yfo\&dl=0)
  * [**Recognito\_Face\_Android\_Pro.zip\[46.7M\]**](https://www.dropbox.com/scl/fi/oszbz04zb9ucp0zdf4lxf/Recognito_Face_Android_Pro.zip?rlkey=yvk93jbxbtlvmcl7g57gohym1\&st=tevuby7j\&dl=0)
* Open the `FaceRecognition` project in Android Studio.

### - Setting Up SDK License Key

* Add license to `assets/license` file:

{% code title="Android-FaceRecognition-FaceLivenessDetection/app/src/main/assets/license" lineNumbers="true" %}

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

{% endcode %}

* Build Project.

### - Integration Guide

* Import FaceSDK

```kotlin
import com.bio.facesdk.FaceBox
import com.bio.facesdk.FaceDetectionParam
import com.bio.facesdk.FaceSDK
```

* Activate and Initialize FaceSDK

```kotlin
var ret = FaceSDK.setActivation(license_str)

if (ret == FaceSDK.SDK_SUCCESS) {
    ret = FaceSDK.init(assets)
}
```

* YUV to Bitmap for camera frame

```kotlin
override fun process(frame: Frame) {
    val bitmap = FaceSDK.yuv2Bitmap(frame.image, frame.size.width, frame.size.height, cameraOrientation)
    ...
```

* Set `FaceDetectionParam` and Detect Face

```kotlin
val faceDetectionParam = FaceDetectionParam()
faceDetectionParam.check_liveness = true
faceDetectionParam.check_liveness_level = SettingsActivity.getLivenessModelType(this)
faceDetectionParam.check_eye_closeness = true // available for pro version
faceDetectionParam.check_face_occlusion = true // available for pro version
faceDetectionParam.check_mouth_opened = true // available for pro version
faceDetectionParam.estimate_age_gender = true // available for pro version
var faceBoxes: List<FaceBox>? = FaceSDK.faceDetection(bitmap, faceDetectionParam)
```

* Extract Face Template

```kotlin
val faceBox = faceBoxes[0]
val templates = FaceSDK.templateExtraction(bitmap, faceBox)
```

* Calculate Similarity

```kotlin
val similarity = FaceSDK.similarityCalculation(templates, person.templates)
```

***

## Application UI

<div><figure><img src="/files/jGuNuRDga2c4QnDsDdaz" alt=""><figcaption></figcaption></figure> <figure><img src="/files/tdXFr34AIpk2rhS6IGuK" alt=""><figcaption></figcaption></figure> <figure><img src="/files/uLOLbY0893owYQtCNN3A" alt=""><figcaption></figcaption></figure> <figure><img src="/files/ghDaUvVcX5HfkE2CB4Nt" alt=""><figcaption></figcaption></figure> <figure><img src="/files/Mv2RxbjrmZd3rwI9Ez8b" alt=""><figcaption></figcaption></figure> <figure><img src="/files/oJEIK3rZY8RUYq7i7c0q" alt=""><figcaption></figcaption></figure></div>
