人脸比对SDK提供对人脸特征提取和比对的能力，输出两张人脸之间的相似度得分，用于辅助判断是否是同一个人。

人脸识别阈值

根据 阈值可以计算出相似度，一般高于最低相似度就认为是同一个人

人脸识别及相似度相关头文件 bef_effect_ai_face_verify.h

1. 创建人脸比对句柄

BEF_SDK_API bef_effect_result_t
bef_effect_ai_face_verify_create(
       const char *face_verify_param_path,
       const int max_face_num,
       bef_effect_handle_t *handle
);

参数说明

2. 人脸比对授权

BEF_SDK_API bef_effect_result_t 
bef_effect_ai_face_verify_check_license(
	bef_effect_handle_t handle, 
	const char *licensePath
);

参数说明

返回值

成功返回 BEF_RESULT_SUC, 失败返回相应错误码, 具体请参考 bef_effect_ai_public_define.h

3. 人脸识别特征提取

多个人脸特提取

BEF_SDK_API bef_effect_result_t
bef_effect_ai_face_extract_feature(
       bef_effect_handle_t handle,
       const unsigned char *image,
       bef_ai_pixel_format pixel_format,
       int image_width,
       int image_height,
       int image_stride,
       bef_ai_rotate_type orientation,
       const bef_ai_face_info *face_input,
       bef_ai_face_verify_info *verify_info_ptr
);

参数说明

返回值

成功返回 BEF_RESULT_SUC, 失败返回相应错误码, 具体请参考 bef_effect_ai_public_define.h
​

单个人脸特征提取

BEF_SDK_API bef_effect_result_t
bef_effect_ai_face_extract_feature_single(
       bef_effect_handle_t handle,
       const unsigned char *image,
       bef_ai_pixel_format pixel_format,
       int image_width,
       int image_height,
       int image_stride,
       bef_ai_rotate_type orientation,
       const bef_ai_face_106 *face_input,
       float *verify_info_ptr
);

​
参数说明

返回值

成功返回 BEF_RESULT_SUC, 失败返回相应错误码, 具体请参考 bef_effect_ai_public_define.h

4. 人脸特征比对

BEF_SDK_API double
bef_effect_ai_face_verify(const float *feature1, 
	const float *feature2, 
	int size
);

参数说明

返回值
返回人脸比对的结果的值

5. 特征相似度计算

BEF_SDK_API double 
bef_effect_ai__dist2score(
	double d
);

参数说明

返回值
根据人脸比对的值，返回两个人人脸之间的相似度的值

6. 销毁人脸比对句柄

BEF_SDK_API void
bef_effect_ai_face_verify_destroy(
        bef_effect_handle_t handle
);

参数说明

1. 创建人脸比对句柄

public int init(Context context, String faceModel,String faceVerifyModel,int maxFaceNum, String license)

参数说明

返回值

成功返回BEF_RESULT_SUC，否则返回对应的错误码

2. 人脸特征提取

人脸特征提取，最多支持10人

public BefFaceFeature extractFeature(ByteBuffer buffer, BytedEffectConstants.PixlFormat pixel_format, int image_width, int image_height, int image_stride, BytedEffectConstants.Rotation orientation)  

参数说明

返回值

人脸特征结果

​

单个人脸特征提取

public BefFaceFeature extractFeatureSingle(ByteBuffer buffer, BytedEffectConstants.PixlFormat pixel_format, int image_width, int image_height, int image_stride, BytedEffectConstants.Rotation orientation)

参数说明

返回值

人脸特征结果

3. 人脸特征比对

public double verify(float[] feature1, float[] feature2)

参数说明

返回值

特征距离

4. 特征相似度计算

public double distToScore(double d)

参数说明

返回值

返回相似度

5. 释放人脸比对句柄

public void release()

FAQ

1.如果出现任何异常，请查看是否有以下类型日志

答：建议首先查看以下tag输出Error类型的日志：
bef_effect_ai 和SMASH_E_LOG 以及 EffectSDK

2.人脸对比初始化失败

答：检查模型路径和授权文件路径是否正确

3.人脸比对提取多个特征时传入人脸信息数组和输出特征数组顺序是否对应

答：是的，对应

错误码

错误码请参考错误码表