Monocular Liveness Detection

Monocular Liveness Detection Interface

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

stid_facepro_create_singleliveness

Function: Create a handle by loading a specified model file

Declaration:

STID_SDK_API
stid_result_t
stid_facepro_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_destroy_singleliveness

Function: Release handle

Declaration:

STID_SDK_API
void
stid_facepro_anti_spoofing_destroy_handle(
    stid_handle_t handle
);

Parameters:

• [in] handle: Handle to be released

Return: None

stid_facepro_anti_spoofing_detect

Function: Anti-hack face detection on input images

Declaration:

STID_SDK_API
stid_result_t
stid_facepro_anti_spoofing_detect(
    stid_handle_t handle,
    const stid_image_t* input_image,
    const stid_landmarks_t* input_landmarks,
    float *out_hack_score
);

Parameters:

• [in] input_landmarks: Face key points

• [out] out_hack_score: Returns hack detection result, within the range of 0~1. The larger the score, the more likely it is a hack.

Return:

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

stid_facepro_anti_spoofing_get_default_hackness_threshold

Function: Obtain the default hack detection threshold

Declaration:

STID_SDK_API
stid_result_t
stid_facepro_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.