key-value 说明

在声网 SDK 提供的插件相关方法和回调中，key 和 value 参数取决于你使用的插件。本页提供火山引擎智能美化特效插件支持的 key 和 value 说明。

方法 key 的 value

注意

本节提供的参数解释仅供参考。更准确详尽的解释请查看接口说明-特效的 C 接口一节，可以通过 key 的名称检索对应的 API。

调用 setExtensionProperty 方法时传入对应的 key 和 value，可以使用火山引擎智能美化特效插件的如下功能：

授权

• key ：bef_effect_ai_check_license
• value ：licensePath，String 型，授权文件的路径。

更多信息请参考特效句柄授权。

初始化

• key ：bef_effect_ai_init
• value ：包含以下参数
  • strModelDir：String 型，资源文件目录路径。
  • deviceName：String 型，设备名。一般输入空字符串（""）即可。

更多信息请参考初始化特效句柄。

设置手机角度

• key ：bef_effect_ai_set_orientation
• value ：orientation，bef_ai_rotate_type 类型，代表旋转角度。可以设为 0（不旋转）、1（顺时针旋转 90 度）、2（顺时针旋转 180 度）、3（顺时针旋转 270 度）。

更多信息请参考设置手机角度。

设置叠加特效（美颜、美形、美妆）

• key ：bef_effect_ai_composer_set_nodes
• value ：nodePaths，特效资源路径的数组。

更多信息请参考设置叠加特效（美颜、美形、美妆）。

设置特效强度（美颜、美形、美妆）

• key ：bef_effect_ai_composer_update_node
• value ：包含以下参数
  • nodePath：String 型，特效资源的路径。
  • nodeTag：String 型，特效的 key，详见素材 key 对应说明。
  • value：float 型，设置组合特效的单个节点的强度。

更多信息请参考设置特效强度（美颜、美形、美妆）。

设置贴纸

• key ：bef_effect_ai_set_effect
• value ：strPath，String 型，特效资源路径。

更多信息请参考设置贴纸。

设置滤镜

• key ：bef_effect_ai_set_color_filter_v2
• value ：strPath，String 型，特效资源路径。

更多信息请参考设置滤镜。

设置滤镜强度

• key ：bef_effect_ai_set_intensity
• value ：fIntensity，float 型，取值范围 [0.0, 1.0] 。设为 0 代表不工作。

更多信息请参考设置强度。

初始化 composer

• key ：bef_effect_ai_set_composer
• value ：strPath，String 型，composer 资源文件路径。

更多信息请参考初始化 composer。

移除 composer

• key ：bef_effect_ai_composer_remove_nodes
• value ：nodePaths，由多个 composer 资源文件路径组成的 String Array。

更多信息请参考 Remove composer node。

回调 key 的 value

该插件暂时没有回调 key。