产品动态
产品近期公告
关于 TRTC Live 正式上线的公告
关于TRTC Conference 正式版上线的公告
Conference 商业化版本即将推出
关于多人音视频 Conference 开启内测公告
关于音视频通话 Call 正式版上线的公告
关于腾讯云音视频终端 SDK 播放升级及新增授权校验的公告
关于 TRTC 应用订阅套餐服务上线的相关说明
BaseBeautyStore 是 AtomicXCore 中负责管理人像基础美颜效果的模块。通过它，您可以轻松为您的直播或通话应用添加自然的美颜效果。BaseBeautyStore 相关的核心概念：核心概念 | 类型 | 核心职责与描述 |
class | 代表基础美颜模块的当前状态。包含了当前生效的磨皮 ( smoothLevel)、美白 (whitenessLevel) 和红润 (ruddyLevel) 的强度值。所有属性均为 ValueListenable<double> 类型，支持订阅监听。 | |
class | 这是与基础美颜功能交互的核心管理类。它是一个全局单例 ( shared)，负责所有基础美颜参数的设置、重置和状态同步。 |
BaseBeautyStore 的全局单例，并设置监听器以实时获取当前的美颜参数状态。BaseBeautyStore.shared 获取全局唯一的 BaseBeautyStore 实例。addListener 监听 baseBeautyState 中各属性的变化，实时获取美颜参数更新。import 'package:flutter/material.dart';import 'package:atomic_x_core/atomicxcore.dart';class BeautyManager {// 1. 获取单例final _baseBeautyStore = BaseBeautyStore.shared;late final VoidCallback _smoothLevelChangedListener = _onSmoothLevelChanged;late final VoidCallback _whitenessLevelChangedListener = _onWhitenessLevelChanged;late final VoidCallback _ruddyLevelChangedListener = _onRuddyLevelChanged;// 2. 订阅状态void subscribeToBeautyState() {_baseBeautyStore.baseBeautyState.smoothLevel.addListener(_smoothLevelChangedListener);_baseBeautyStore.baseBeautyState.whitenessLevel.addListener(_whitenessLevelChangedListener);_baseBeautyStore.baseBeautyState.ruddyLevel.addListener(_ruddyLevelChangedListener);}void _onSmoothLevelChanged() {final level = _baseBeautyStore.baseBeautyState.smoothLevel.value;debugPrint('磨皮强度变化: $level');}void _onWhitenessLevelChanged() {final level = _baseBeautyStore.baseBeautyState.whitenessLevel.value;debugPrint('美白强度变化: $level');}void _onRuddyLevelChanged() {final level = _baseBeautyStore.baseBeautyState.ruddyLevel.value;debugPrint('红润强度变化: $level');}// 退出 App 应用前执行 dispose 操作void dispose() {_baseBeautyStore.baseBeautyState.smoothLevel.removeListener(_smoothLevelChangedListener);_baseBeautyStore.baseBeautyState.whitenessLevel.removeListener(_whitenessLevelChangedListener);_baseBeautyStore.baseBeautyState.ruddyLevel.removeListener(_ruddyLevelChangedListener);}}
Slider）获取用户设定的强度值。SDK 接口接收的参数范围是 0-9，其中 0 表示关闭效果，9 表示效果最明显。您需要将 UI 控件的值（例如 Slider 的 0.0 - 1.0）映射到 0 - 9 的范围。setSmoothLevel()、setWhitenessLevel()、setRuddyLevel() 来设置磨皮、美白、红润的强度。extension BeautyManagerExtension on BeautyManager {/// 设置磨皮强度 (输入范围 0.0 ~ 1.0, 内部转换为 0 ~ 9)void updateSmoothLevel(double uiLevel) {// 将 UI 的 0.0 ~ 1.0 映射到 SDK 的 0 ~ 9final sdkLevel = uiLevel * 9.0;_baseBeautyStore.setSmoothLevel(sdkLevel);}/// 设置美白强度 (输入范围 0.0 ~ 1.0, 内部转换为 0 ~ 9)void updateWhitenessLevel(double uiLevel) {final sdkLevel = uiLevel * 9.0;_baseBeautyStore.setWhitenessLevel(sdkLevel);}/// 设置红润强度 (输入范围 0.0 ~ 1.0, 内部转换为 0 ~ 9)void updateRuddyLevel(double uiLevel) {final sdkLevel = uiLevel * 9.0;_baseBeautyStore.setRuddyLevel(sdkLevel);}}
baseBeautyStore.reset() 方法。extension BeautyManagerReset on BeautyManager {/// 重置所有基础美颜效果void resetBeautyEffects() {_baseBeautyStore.reset();}}
ValueListenableBuilder 来构建响应式 UI，当美颜参数变化时自动更新界面：class BeautySliderWidget extends StatelessWidget {final beautyStore = BaseBeautyStore.shared;@overrideWidget build(BuildContext context) {return Column(children: [// 磨皮滑块ValueListenableBuilder<double>(valueListenable: beautyStore.baseBeautyState.smoothLevel,builder: (context, smoothLevel, child) {return Row(children: [Text('磨皮'),Expanded(child: Slider(value: smoothLevel,min: 0,max: 9,divisions: 9,onChanged: (value) {beautyStore.setSmoothLevel(value);},),),Text('${smoothLevel.toInt()}'),],);},),// 美白滑块ValueListenableBuilder<double>(valueListenable: beautyStore.baseBeautyState.whitenessLevel,builder: (context, whitenessLevel, child) {return Row(children: [Text('美白'),Expanded(child: Slider(value: whitenessLevel,min: 0,max: 9,divisions: 9,onChanged: (value) {beautyStore.setWhitenessLevel(value);},),),Text('${whitenessLevel.toInt()}'),],);},),// 红润滑块ValueListenableBuilder<double>(valueListenable: beautyStore.baseBeautyState.ruddyLevel,builder: (context, ruddyLevel, child) {return Row(children: [Text('红润'),Expanded(child: Slider(value: ruddyLevel,min: 0,max: 9,divisions: 9,onChanged: (value) {beautyStore.setRuddyLevel(value);},),),Text('${ruddyLevel.toInt()}'),],);},),],);}}
import 'package:flutter/material.dart';import 'package:atomic_x_core/atomicxcore.dart';class BeautySettingsPage extends StatelessWidget {final beautyStore = BaseBeautyStore.shared;@overrideWidget build(BuildContext context) {return Scaffold(appBar: AppBar(title: Text('美颜设置')),body: Padding(padding: EdgeInsets.all(16),child: Column(children: [// 磨皮_buildBeautySlider(title: '磨皮',valueListenable: beautyStore.baseBeautyState.smoothLevel,onChanged: (value) => beautyStore.setSmoothLevel(value),),SizedBox(height: 20),// 美白_buildBeautySlider(title: '美白',valueListenable: beautyStore.baseBeautyState.whitenessLevel,onChanged: (value) => beautyStore.setWhitenessLevel(value),),SizedBox(height: 20),// 红润_buildBeautySlider(title: '红润',valueListenable: beautyStore.baseBeautyState.ruddyLevel,onChanged: (value) => beautyStore.setRuddyLevel(value),),SizedBox(height: 40),// 重置按钮ElevatedButton(onPressed: () {beautyStore.reset();},child: Text('重置美颜'),),],),),);}Widget _buildBeautySlider({required String title,required ValueListenable<double> valueListenable,required ValueChanged<double> onChanged,}) {return ValueListenableBuilder<double>(valueListenable: valueListenable,builder: (context, value, child) {return Column(crossAxisAlignment: CrossAxisAlignment.start,children: [Row(mainAxisAlignment: MainAxisAlignment.spaceBetween,children: [Text(title, style: TextStyle(fontSize: 16)),Text('${value.toInt()}', style: TextStyle(fontSize: 16)),],),Slider(value: value,min: 0,max: 9,divisions: 9,onChanged: onChanged,),],);},);}}
对比项 | 基础美颜 (BaseBeautyStore) | 高级美颜 (TencentEffect 需额外集成) |
核心功能 | 磨皮、美白、红润 | 包含基础美颜，并增加 V 脸、眼距、瘦鼻、3D 贴纸、滤镜、美妆等丰富效果 |
计费 | 免费 (包含在 AtomicXCore 授权内) | 付费（需要额外购买腾讯特效 SDK License） |
集成方式 | 默认内置，直接使用 BaseBeautyStore.shared | 需要额外集成 TencentEffect 组件并进行鉴权 |
推荐场景 | 对美颜要求不高，需要快速实现基础美颜功能的场景 | 对美颜效果有较高要求，需要丰富的美型、贴纸、滤镜等高级功能的场景 |
属性/方法 | 类型 | 说明 |
shared | BaseBeautyStore | 单例实例 |
baseBeautyState | BaseBeautyState | 美颜状态 |
setSmoothLevel | void | 设置磨皮强度（0-9） |
setWhitenessLevel | void | 设置美白强度（0-9） |
setRuddyLevel | void | 设置红润强度（0-9） |
reset | void | 重置所有美颜参数至默认值（0） |
属性 | 类型 | 说明 |
smoothLevel | ValueListenable<double> | 磨皮强度（0-9） |
whitenessLevel | ValueListenable<double> | 美白强度（0-9） |
ruddyLevel | ValueListenable<double> | 红润强度（0-9） |
DeviceStore.shared.openLocalCamera()），美颜效果才能应用到视频流上。TencentEffect (高级美颜)，请确保您使用的是 TencentEffect 提供的接口来调节美颜。0 到 9 之间的 double 值）。文档反馈