TUILiveKit 产品动态
云直播推拉流 SDK 产品动态
BaseBeautyStore 是 AtomicXCore 中负责管理人像基础美颜效果的模块。通过它,您可以轻松为您的直播或通话应用添加自然的美颜效果。核心概念 | 类型 | 核心职责与描述 |
BaseBeautyState | data class | 代表基础美颜模块的当前状态。包含了当前生效的磨皮 ( smoothLevel)、美白 (whitenessLevel) 和红润 (ruddyLevel) 的强度值。 |
BaseBeautyStore | abstract class | 这是与基础美颜功能交互的核心管理类。它是一个全局单例 ( shared),负责所有基础美颜参数的设置、重置和状态同步。 |
BaseBeautyStore 的全局单例,并设置订阅者以实时获取当前的美颜参数状态。BaseBeautyStore.shared() 获取全局唯一的 BaseBeautyStore 实例。baseBeautyStore.baseBeautyState 以实时获取 BaseBeautyState 的更新。import io.trtc.tuikit.atomicxcore.api.device.BaseBeautyStateimport io.trtc.tuikit.atomicxcore.api.device.BaseBeautyStoreimport kotlinx.coroutines.CoroutineScopeimport kotlinx.coroutines.Dispatchersimport kotlinx.coroutines.launchimport kotlinx.coroutines.flow.MutableStateFlowclass BeautyManager() {// 1. 获取单例private val baseBeautyStore = BaseBeautyStore.shared()private val coroutineScope = CoroutineScope(Dispatchers.Main)private val _smoothLevel = MutableStateFlow(0f)private val _whitenessLevel = MutableStateFlow(0f)private val _ruddyLevel = MutableStateFlow(0f)// 对外暴露美颜状态val baseBeautyState = BaseBeautyState(smoothLevel = _smoothLevel,whitenessLevel = _whitenessLevel,ruddyLevel = _ruddyLevel)init {// 2. 订阅状态subscribeToBeautyState()}private fun subscribeToBeautyState() {coroutineScope.launch(Dispatchers.Main) {baseBeautyStore.baseBeautyState.smoothLevel.collect { smoothLevel ->_smoothLevel.value = smoothLevel}}coroutineScope.launch(Dispatchers.Main) {baseBeautyStore.baseBeautyState.whitenessLevel.collect { whitenessLevel ->_whitenessLevel.value = whitenessLevel}}coroutineScope.launch(Dispatchers.Main) {baseBeautyStore.baseBeautyState.ruddyLevel.collect { ruddyLevel ->_ruddyLevel.value = ruddyLevel}}}// ... 后续方法}
SeekBar)获取用户设定的强度值。请注意,SDK 接口接收的参数范围是 [0, 9],其中 0 表示关闭效果,9 表示效果最明显。您需要将 UI 控件的值(例如 SeekBar 的 0 - 100)映射到 0 - 9 的范围。setSmoothLevel(smoothLevel:)、setWhitenessLevel(whitenessLevel:)、setRuddyLevel(ruddyLevel:) 来设置磨皮、美白、红润的强度。class BeautyManager() {private val baseBeautyStore = BaseBeautyStore.shared()/// 设置磨皮等级 (输入范围 0 ~ 100, 内部转换为 0 ~ 9)fun updateSmoothLevel(uiLevel: Int) {// 将 UI 的 0 ~ 100 映射到 SDK 的 0 ~ 9val sdkLevel = (uiLevel / 100.0f * 9.0f)baseBeautyStore.setSmoothLevel(sdkLevel)println("设置磨皮等级: UI=$uiLevel, SDK=$sdkLevel")}/// 设置美白等级 (输入范围 0 ~ 100, 内部转换为 0 ~ 9)fun updateWhitenessLevel(uiLevel: Int) {val sdkLevel = (uiLevel / 100.0f * 9.0f)baseBeautyStore.setWhitenessLevel(sdkLevel)println("设置美白等级: UI=$uiLevel, SDK=$sdkLevel")}/// 设置红润等级 (输入范围 0 ~ 100, 内部转换为 0 ~ 9)fun updateRuddyLevel(uiLevel: Int) {val sdkLevel = (uiLevel / 100.0f * 9.0f)baseBeautyStore.setRuddyLevel(sdkLevel)println("设置红润等级: UI=$uiLevel, SDK=$sdkLevel")}}
class BeautyManager() {private val baseBeautyStore = BaseBeautyStore.shared()/// 重置所有基础美颜效果fun resetBeautyEffects() {baseBeautyStore.reset()}}
对比项 | 基础美颜 (BaseBeautyStore) | 高级美颜 (TEBeautyKit 需额外集成) |
核心功能 | 磨皮、美白、红润 | 包含基础美颜,并增加 V脸、眼距、瘦鼻、3D 贴纸、滤镜、美妆等丰富效果 |
计费 | 免费 (包含在 AtomicXCore 授权内) | 付费(需要额外购买腾讯特效 SDK License) |
集成方式 | 默认内置,直接使用 BaseBeautyStore.shared() | 需要额外集成 TEBeautyKit 组件并进行鉴权 |
推荐场景 | 对美颜要求不高,需要快速实现基础美颜功能的场景 | 对美颜效果有较高要求,需要丰富的美型、贴纸、滤镜等高级功能的场景 |
DeviceStore.shared().openLocalCamera),美颜效果才能应用到视频流上。TEBeautyKit (高级美颜),请确保您使用的是 TEBeautyKit 提供的接口来调节美颜。0 到 9 之间的 Float 值)。文档反馈