人脸聚类

人脸聚类SDK提供人像聚类的能力，方便将属于同一个人的照片聚成一类，常应用于智能相册中。

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

人脸聚类

1. 创建人脸聚类句柄

BEF_SDK_API bef_effect_result_t bef_effect_ai_fc_create(bef_effect_handle_t *handle);

参数说明

返回值

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

2. 人脸聚类授权

android接口

BEF_SDK_API bef_effect_result_t bef_effect_ai_face_cluster_check_license(
    JNIEnv* env,
    jobject context, 
    bef_effect_handle_t handle, 
    const char *license_path
);

参数说明

返回值

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

ios接口

BEF_SDK_API bef_effect_result_t bef_effect_ai_face_cluster_check_license(
    bef_effect_handle_t handle,
    const char *license_path
);

参数说明

返回值

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

3. 人脸聚类参数设置

BEF_SDK_API bef_effect_result_t bef_effect_ai_fc_set_param(
    bef_effect_handle_t handle, 
    bef_ai_fc_param_type type, 
    float value
);

参数说明

返回值

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

4. 人脸聚类接口

BEF_SDK_API bef_effect_result_t  bef_effect_ai_fc_do_clustering(
    bef_effect_handle_t handle,
    float *const features,
    const int num_samples,
    int *clusters
);

参数说明

返回值

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

5. 释放人脸聚类句柄

BEF_SDK_API bef_effect_result_t bef_effect_ai_fc_release(bef_effect_handle_t handle);

参数说明

人脸聚类相关的函数定义在com.bytedance.labcv.effectsdk.FaceCluster.java文件中。

人脸聚类

1. 初始化人脸聚类句柄

public int init(
    Context context, 
    String license
)

参数说明

返回值

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

2. 设置聚类参数

public int setDetectParam(
    int paramType , 
    int paramValue
)

参数说明

返回值

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

3. 人脸特征聚类

public int[] cluster(
    float[][] features, 
    int numSize
)

参数说明

返回值

聚类结果，每个特征所属类别的数组

备注

聚类结果result[i] = 0， 表示第i个features的属于第0类

4. 释放人脸聚类接口

public void release()

FAQ

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

答：建议首先查看以下tag输出Error类型的日志：

bef_effect_ai 和SMASH_E_LOG 以及 EffectSDK

错误码

错误码请参考错误码表