# API Reference ### setActivation {% code overflow="wrap" %} ```kotlin public static native int setActivation(String var0); ``` {% endcode %}


Name	setActivation
Description	Activate SDK
Input	var0 (String): The license string
Output	The SDK activation status code. 0: Success Non-zero: Activation failed

### init {% code overflow="wrap" %} ```kotlin public static native int init(AssetManager var0); ``` {% endcode %}


Name	init
Description	Initiate SDK
Input	var0 (AssetManager): An instance of AssetManager used to access application assets
Output	The SDK initialization status code. 0: Success -1: License Key Error -2: License AppID Error -3: License Expired -4: Activate Error -5: Initialize SDK Error

### yuv2Bitmap {% code overflow="wrap" %} ```kotlin public static native Bitmap yuv2Bitmap(byte[] nv21, int width, int height, int orientation); ``` {% endcode %}


Name	yuv2Bitmap
Description	Convert YUV camera frame to Bitmap image
Input	nv21 (byte[]): Byte array representing the YUV image data in NV21 format width (int): Width of the image height (int): Height of the image orientation (int): Orientation of the image 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
Output	A Bitmap object representing the converted image

### faceDetection {% code overflow="wrap" %} ```kotlin public static native List faceDetection(Bitmap var0, FaceDetectionParam var1); ``` {% endcode %}


Name	faceDetection
Description	Detect Face
Input	var0 (Bitmap): The Bitmap image var1 (FaceDetectionParam): Parameters for face detection
Output	A list of FaceBox objects representing the detected faces.

#### FaceDetectionParam * **FaceSDK - Core** {% code overflow="wrap" %} ```kotlin public class FaceDetectionParam { public boolean check_liveness = false; public int check_liveness_level = 0; // 0: more accurate model, 1: lighter model } ``` {% endcode %} * **FaceSDK - Pro** {% code overflow="wrap" %} ```kotlin public class FaceDetectionParam { public boolean check_liveness = false; public int check_liveness_level = 0; // 0: more accurate model, 1: lighter model public boolean check_eye_closeness = false; public boolean check_face_occlusion = false; public boolean check_mouth_opened = false; public boolean estimate_age_gender = false; } ``` {% endcode %} #### FaceBox * **FaceSDK - Core** {% code overflow="wrap" %} ```kotlin 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; } ``` {% endcode %} * **FaceSDK - Pro** {% code overflow="wrap" %} ```kotlin public class FaceBox { public int x1; public int y1; public int x2; public int y2; public float yaw; public float roll; public float pitch; public float face_quality; public float face_luminance; public float liveness; public float left_eye_closed; public float right_eye_closed; public float face_occlusion; public float mouth_opened; public int age; public int gender; public float[] landmarks_68; } ``` {% endcode %} The liveness score ranges from 0.0 to 1.0\ **Default Liveness Threshold is 0.7** ### templateExtraction {% code overflow="wrap" %} ```kotlin public static native byte[] templateExtraction(Bitmap var0, FaceBox var1); ``` {% endcode %}


Name	templateExtraction
Description	Extract face feature
Input	var0 (Bitmap): The Bitmap image var1 (FaceBox): The bounding box of the detected face
Output	A byte array representing the extracted template from the face

### similarityCalculation {% code overflow="wrap" %} ```kotlin public static native float similarityCalculation(byte[] var0, byte[] var1); ``` {% endcode %}


Name	similarityCalculation
Description	Calculate similarity between two face features
Input	var0 (byte[]): The byte array representing the first face template var1 (byte[]): The byte array representing the second face template
Output	A float value representing the similarity score between the two face templates The score ranges from 0.0 to 1.0 Default Threshold is 0.8

--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.recognito.vision/face-liveness-detection-sdk/integration-guide/android/api-reference.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.