# Basic SDK - Android ## Features * [x] Face Detection * [x] Face Liveness Detection * [x] Pose Estimation * [x] Fully-Offline Works and On-Premise ## License We offer `lifetime license(perpetual license)` tied to each `application ID` for `Android` `SDK`s. The license is available with a `one-time payment`—meaning once you purchase it, you can use our `SDK` indefinitely without any recurring fees. To request a license, please contact us: > **Email:** > > **Telegram:** @kbyaisupport > > **WhatsApp:** +19092802609 ## System Requirements * **CPU:** 2 cores or more * **RAM:** 100MB or more * **OS:** Android 4.4 or later * **Architecture:** arm64-v8a, armeabi-v7a ## Setup 1. Copy the SDK (`libfacesdk` folder) to the `root` folder of your project. 2. Add SDK to the project in settings.gradle ```gradle include ':libfacesdk' ``` 3. Add dependency to your `build.gradle` ```gradle implementation project(path: ':libfacesdk') ``` ## Initializing SDK 1. Step one * To begin, you need to activate the SDK using the license that you have received. ```java FaceSDK.setActivation("..."); ``` * If activation is successful, the return value will be `SDK_SUCCESS`. Otherwise, an error value will be returned. 2. Step Two * After activation, call the SDK's initialization function. ```java FaceSDK.init(getAssets()); ``` * If initialization is successful, the return value will be `SDK_SUCCESS`. Otherwise, an error value will be returned. ## Enums and Classes ### 1. SDK\_ERROR This enumeration represents the return value of the `init` and `setActivation` functions.

Feature	Value	Name
Successful activation or initialization	0	SDK_SUCCESS
License key error	-1	SDK_LICENSE_KEY_ERROR
AppID error (Not used in Server SDK)	-2	SDK_LICENSE_APPID_ERROR
License expiration	-3	SDK_LICENSE_EXPIRED
Not activated	-4	SDK_NO_ACTIVATED
Failed to initialize SDK	-5	SDK_INIT_ERROR

### 2. FaceBox This class represents the output of the `face detection` function that contains the detected `face rectangle`, `liveness score`, and `facial angles` such as `yaw`, `roll`, and `pitch`. | Feature | Type | Name | | ----------------------- | ----- | ---------------- | | Face rectangle | int | x1, y1, x2, y2 | | Face angles (-45 \~ 45) | float | yaw, roll, pitch | | Liveness score (0 \~ 1) | float | liveness |

## APIs ### 1. setActivation To begin, you need to activate the SDK using the license that you have received. ```kotlin var ret = FaceSDK.setActivation("...") ``` If activation is successful, the return value will be `SDK_SUCCESS`. Otherwise, an error value will be returned. ### 2. init After activation, call the SDK's initialization function. ```kotlin ret = FaceSDK.init(assets) ``` If initialization is successful, the return value will be `SDK_SUCCESS`. Otherwise, an error value will be returned. ### 3. faceDetection The SDK offers a single function for detecting face and liveness detection, which can be used as follows: ```kotlin 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. ### 4. yuv2Bitmap 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: ```java Bitmap bitmap = FaceSDK.yuv2Bitmap(nv21, image.getWidth(), image.getHeight(), 7); ``` The 1st parameter is a `nv21` byte array containing the `yuv` data. The 2nd parameter is the width of the `yuv` frame, and the 3rd 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 ``` ## Default Thresholds ```kotlin val livenessThreshold = 0.7 ``` If the liveness score exceeds `0.7`, we can regard `input face` as a `real face`.