# 商汤高级美颜/特效键值说明 (/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" />