You need to enable JavaScript to run this app.
文档中心
智能美化特效

智能美化特效

请输入
  • 文档首页
    • 智能美化特效多人脸接口说明-特效
复制全文
下载 pdf
我的收藏
智能美化特效
多人脸接口说明-特效
复制全文
下载 pdf
我的收藏
多人脸接口说明-特效
功能说明​
适用范围：本文仅说明 SDK 4.9.0 新增的两个多人脸特效接口：按 FREID 设置多人脸特效强度，以及获取多人脸 FREID 检测结果。​
接入前提​
SDK 初始化、鉴权、特效句柄创建、素材加载、图像处理和资源释放均复用普通特效流程，本文不再重复说明。​
  • 使用下述接口前，请确保 SDK 版本不低于 4.9.0，并已按普通特效流程完成初始化。​
​
C 接口​
头文件：bef_effect_ai_api.h。初始化、素材加载、图像处理和资源释放复用普通特效 C 接口。​
1. 设置多人脸特效强度​
​
​
BEF_SDK_API bef_effect_result_t bef_effect_ai_composer_update_string_node(bef_effect_handle_t handle, const char *nodePath, const char *nodeTag, const char *strVal);​
​
参数说明​
​
参数名 ​
参数类型 ​
参数说明 ​
nodePath ​
const char * ​
特效资源的路径​
nodeTag ​
const char * ​
特效的强度​
handle ​
bef_effect_handle_t ​
已创建的特效句柄 ​
strVal ​
const char * ​
字符串格式的强度值​
​
返回值​
成功返回 BEF_RESULT_SUC, 失败返回相应错误码, 具体请参考 bef_effect_ai_public_define.h​
​
​
2.获取多人脸检测结果​
​
BEF_SDK_API bef_effect_result_t bef_effect_ai_get_freid_detect_result(bef_effect_handle_t handle, bef_ai_freid_detect_result* result);​
​
参数说明​
​
参数名 ​
参数类型 ​
参数说明 ​
result ​
bef_ai_face_occlusion_info*​
freid结果​
handle ​
bef_effect_handle_t ​
已创建的特效句柄 ​
​
返回值​
成功返回 BEF_RESULT_SUC, 失败返回相应错误码, 具体请参考 bef_effect_ai_public_define.h​
​
Java 接口​
对应类为 RenderManager.java。初始化、素材加载、图像处理和资源释放复用普通特效 Java 接口。​
​
1. 设置多人脸特效强度​
​
public int updateComposerStringNode(String path, String key, String value)​
​
参数说明​
​
参数名​
参数类型​
参数说明​
path​
String​
特效素材对应路径​
key​
String​
特效 KEY​
value​
String​
多人脸强度值，{"values":[{"freid":"人脸唯一标识","value":0-1强度值}]}​
​
返回值​
成功返回BEF_RESULT_SUC， 其他返回值查看{@link BytedEffectConstants}​
​
2. 获取多人脸检测结果​
​
/** {zh} * @return 当前 多人脸 FREID 检测结果 * @brief 获取当前 RenderManager 输出的 FREID 检测结果 */​
public BefFreidInfo getFreidDetectResult()​
​
返回值 ​
成功返回 BefFreidInfo 对象，失败返回 null。​
​
最近更新时间：2026.09.18 14:46:30
这个页面对您有帮助吗？
有用
有用
无用
无用