增强模式使用指引
增强模式是什么?
SDK 建议设置的各项美颜参数范围是0 ~ 100或-100 ~ 100( 见 美颜参数说明),在此范围内调整数值,通常都能达到令人满意的美颜效果。如果将强度调整到最大值或最小值之后仍然无法满足需求,则可以考虑使用增强模式,增强模式可以让美颜效果更明显,例如磨皮更明显、瘦脸瘦得更多等。
如何使用增强模式
在 SDK 3.5.0版本之后,我们优化了增强模式的使用方式,您只需要设置更大的数值给 SDK 即可,例如建议的数值范围是-100 ~ 100,那您可以设置-120 ~ 120给 SDK。
1. 如果您使用了我们的 UI 组件 TEBeautyKit:
请调用
TEBeautyKit
的enableEnhancedMode
方法,调用后,TEBeautyKit就会将面板上显示的数值乘以合适的倍数再设置给SDK。例如在UI面板上设置的瘦脸数值是80,TEBeautyKit会将它乘以 1.2 变成 96 再设置给 SDK。2. 如果您没有使用 TEBeautyKit 而是直接使用 XmagicApi:
调用 XmagicApi 的 setEffect 方法时,将 value 数值乘以合适的倍数即可。
1. 如果您使用了我们的 UI 组件 TEBeautyKit:
使用
TEPanelView
,调用setEnhancedMode
方法,调用后,TEBeautyKit 就会将面板上显示的数值乘以合适的倍数再设置给 SDK。例如在 UI 面板上设置的瘦脸数值是80,TEBeautyKit 会将它乘以1.2变成96再设置给 SDK。/** * * 开启增强模式 * @param enhancedMode 是否开启增强模式。YES:开启增强模式;NO:不开启增强模式。默认不开启增强模式。 */[self.tePanelView setEnhancedMode:YES];
2. 如果您没有使用 TEBeautyKit而是直接使用
XMagic
对象:调用 setEffect 方法时,将 value 数值乘以合适的倍数即可。
1. 调用
TencentEffectApi
的enableEnhancedMode
方法开启增强模式。2. 使用
setEffect
方法设置美颜参数时,effectValue
的最大值可以为下表推荐的最大值。void setEffect(String effectName,int effectValue,String? resourcePath,Map<String,String>? extraInfo);
1. 调用
XmagicApi
的enableEnhancedMode
方法开启增强模式。2. 使用
setEffect
方法设置美颜参数时,effectValue
的最大值可以为下表推荐的最大值。/** * 更新美颜对象 * @param effect 对象结构如下 * { * effectName:"",不为空的字符串,参考美颜参数表 * effectValue: 数值,一般为-100---100的值,可参考官网的美颜参数表 * resourcePath: 资源文件的路径,请参考美颜参数表 https://cloud.tencent.com/document/product/616/103616 * extraInfo:一个map集合,具体数值请参考美颜参数表 * } */ static setEffect(effect)
增强模式推荐的增强倍数
我们提供了一份增强倍数的参考值,不建议超出我们的推荐值,否则美颜效果可能变差。参考值见下:
美颜项名称 | 建议最大增强倍数 |
美白,短脸,V脸,眼距,鼻子位置,祛法令纹,口红,立体 | 1.3倍 |
亮眼 | 1.5倍 |
腮红 | 1.8倍 |
其他 | 1.2倍 |
| |
| |
| |