Binocular Liveness Detection

Binocular liveness Detection Interface

Windows/Linux/Arm_Linux interface is described here, for Android interface please refer to Android interface description.

stid_facepro_binocular_anti_spoofing_create_handle

Function: Create a handle by loading a specified model file.

Declaration:

STID_SDK_API
stid_result_t
stid_facepro_binocular_anti_spoofing_create_handle(
    stid_handle_t* out_handle,
    const char *model_filename
);

Parameters:

• [in] model_filename: Pass the location of the model file.

• [out] out_handle: Return the initialized handle, when not in use, call stid_face_anti_spoofing_destroy_handle to release resource.

Return:

• [return] Return STID_OK if successful, otherwise return error code.

stid_facepro_binocular_anti_spoofing_destroy_handle

Function: Release handle.

Declaration:

STID_SDK_API
void
stid_facepro_binocular_anti_spoofing_destroy_handle(
    stid_handle_t handle
);

Parameters:

• [in] handle: Handle to be released.

Return: None.

stid_facepro_binocular_anti_spoofing_detect

Function: Anti-hack face detection on input images.

Declaration:

STID_SDK_API
stid_result_t
stid_facepro_binocular_anti_spoofing_detect(
    stid_handle_t handle,
    const stid_image_t* rgb_input_image,
    const stid_image_t* infrared_input_image,
    const stid_landmarks_t* rgb_input_landmarks,
    const stid_landmarks_t* infrared_input_landmarks,
    float *out_hack_score
);

Parameters:

• [in] infrared_input_image: Input one frame of image from a near-infrared camera, support up, down, left and right orientations. Facing up is recommended for better performance.

• [in] rgb_input_landmarks: Face key points.

• [in] infrared_input_landmarks: Face key points.

• [out] out_hack_score: Return hack detection result, ranging from 0 to 1. A larger score indicates a higher possibility of hack.

Return:

• [return]Return STID_OK if successful, otherwise return error code.

stid_facepro_binocular_anti_spoofing_get_default_hackness_threshold

Function: Obtain default threshold for hack detection.

Declaration:

STID_SDK_API
stid_result_t
stid_facepro_binocular_anti_spoofing_get_default_hackness_threshold(
    stid_handle_t handle,
    float *out_default_hackness_threshold
);

Parameters:

• [in] handle: Initialized handle.

• [out] out_default_hackness_threshold: Return anti-hack detection threshold, when the hackness_score < this threshold, the anti-hack detection is passed.

Return:

• [return] Return STID_OK if successful, otherwise return error code.