# 商汤高级美颜/特效键值说明 (/zh-CN/realtime-media/marketplace/reference/sensetime-ar-api) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). <_PlatformTabsGroup> <_PlatformProcessedMarker groupMode="structured" canonicalPlatform="android" platform="android" /> 在声网 SDK 提供的插件相关方法和回调中,`key` 和 `value` 参数取决于你使用的插件。本页提供商汤高级美颜/特效系列插件支持的 `key` 和 `value` 说明。 ## 方法 key 的 value [#方法-key-的-value] :::warning[注意] 本节提供的参数解释仅供参考,更准确详尽的解释请查看商汤 SenseAR Effects SDK 的文档(包含在商汤美颜插件的资源包内)。 ::: 调用 `setExtensionProperty` 方法时传入对应的 `key` 和 `value`,可以使用商汤高级美颜/特效系列插件的如下功能: ### 检查激活码 [#检查激活码] - `key` :`st_mobile_check_activecode` - `value` :`license_path`,String 型,本地 License 文件的路径。 ### 创建人体行为检测句柄 [#创建人体行为检测句柄] - `key` :`st_mobile_human_action_create` - `value` :包含以下参数 - `model_path`:String 型,模型文件的路径,例如 `models/action.model`。 - `config`:Int 型,配置选项。检测视频设为 `ST_MOBILE_HUMAN_ACTION_DEFAULT_CONFIG_VIDEO`,检测图片设为 `ST_MOBILE_HUMAN_ACTION_DEFAULT_CONFIG_IMAGE`。 ### 创建特效句柄 [#创建特效句柄] - `key` :`st_mobile_effect_create_handle` - `value` :无,设为 `{}` 即可。 ### 设置美颜的强度 [#设置美颜的强度] - `key` :`st_mobile_effect_set_beauty_strength` - `value` :包含以下参数: - `param`:Int 型,美颜类型。可在[集成插件](/zh-CN/realtime-media/marketplace/build/integrate-extensions/sensetime-ar#1-集成-sdk-和插件)后引用 `STEffectBeautyType` 类。 - `val`:Double 型,美颜强度。 ### 加载美颜素材 [#加载美颜素材] 目前对美颜支持设置美白、红润两种自定义的素材。 - `key` :`st_mobile_effect_set_beauty` - `value` :包含以下参数 - `param`:Int 型,美颜类型。可在[集成插件](/zh-CN/realtime-media/marketplace/build/integrate-extensions/sensetime-ar#1-集成-sdk-和插件)后引用 `STEffectBeautyType` 类。 - `path`:String 型,待添加的素材文件路径。将 `path` 参数设置为 `nullptr`,可以清空之前类型设置的对应素材(如美颜、美妆、滤镜素材)。 ## 回调 key 的 value [#回调-key-的-value] 该插件暂时没有回调 `key`。 <_PlatformProcessedMarker close="true" /> <_PlatformProcessedMarker groupMode="structured" canonicalPlatform="android" platform="ios" /> 在声网 SDK 提供的插件相关方法和回调中,`key` 和 `value` 参数取决于你使用的插件。本页提供商汤高级美颜/特效系列插件支持的 `key` 和 `value` 说明。 ## 方法 key 的 value [#方法-key-的-value-1] :::warning[注意] 本节提供的参数解释仅供参考,更准确详尽的解释请查看商汤 SenseAR Effects SDK 的文档(包含在商汤美颜插件的资源包内)。 ::: 调用 `setExtensionPropertyWithVendor` 方法时传入对应的 `key` 和 `value`,可以使用商汤高级美颜/特效系列插件的如下功能: ### 检查激活码 [#检查激活码-1] - `key` :`st_mobile_check_activecode` - `value` :`license_path`,String 型,本地 License 文件的路径。 ### 创建人体行为检测句柄 [#创建人体行为检测句柄-1] - `key` :`st_mobile_human_action_create` - `value` :包含以下参数 - `model_path`:String 型,模型文件的路径,例如 `models/action.model`。 - `config`:Int 型,配置选项。检测视频设为 `ST_MOBILE_HUMAN_ACTION_DEFAULT_CONFIG_VIDEO`,检测图片设为 `ST_MOBILE_HUMAN_ACTION_DEFAULT_CONFIG_IMAGE`。 ### 创建特效句柄 [#创建特效句柄-1] - `key` :`st_mobile_effect_create_handle` - `value` :无,设为 `{}` 即可。 ### 设置美颜的强度 [#设置美颜的强度-1] - `key` :`st_mobile_effect_set_beauty_strength` - `value` :包含以下参数: - `param`:Int 型,美颜类型。详见 `st_effect_beauty_type_t` 枚举(在 iOS 资源包的 `include/st_mobile_effect.h` 文件中)。 - `val`:Double 型,美颜强度。 ### 加载美颜素材 [#加载美颜素材-1] 目前对美颜支持设置美白、红润两种自定义的素材。 - `key` :`st_mobile_effect_set_beauty` - `value` :包含以下参数 - `param`:Int 型,美颜类型。详见 `st_effect_beauty_type_t` 枚举(在 iOS 资源包的 `include/st_mobile_effect.h` 文件中)。 - `path`:String 型,待添加的素材文件路径。将 `path` 参数设置为 `nullptr`,可以清空之前类型设置的对应素材(如美颜、美妆、滤镜素材)。 ## 回调 key 的 value [#回调-key-的-value-1] 该插件暂时没有回调 `key`。 <_PlatformProcessedMarker close="true" />