tencent cloud

实时音视频

动态与公告
产品动态
产品近期公告
关于 TRTC Live 正式上线的公告
关于TRTC Conference 正式版上线的公告
Conference 商业化版本即将推出
关于多人音视频 Conference 开启内测公告
关于音视频通话 Call 正式版上线的公告
关于腾讯云音视频终端 SDK 播放升级及新增授权校验的公告
关于 TRTC 应用订阅套餐服务上线的相关说明
产品简介
产品概述
基本概念
产品功能
产品优势
应用场景
性能数据
购买指南
计费概述
免费时长说明
月订阅
现收现付
TRTC 逾期与暂停政策
常见问题解答
退款说明
新手指引
Demo 体验
视频通话 SDK
组件介绍
开通服务
跑通 Demo
快速接入
离线唤醒
会话聊天
云端录制
AI 降噪
界面定制
Chat 集成通话能力
更多特性
无 UI 集成
服务端 API
客户端 API
解决方案
错误码表
发布日志
常见问题
视频会议 SDK
组件介绍(TUIRoomKit)
开通服务(TUIRoomKit)
跑通 Demo(TUIRoomKit)
快速接入(TUIRoomKit)
屏幕共享(TUIRoomKit)
预定会议(TUIRoomKit)
会中呼叫(TUIRoomKit)
界面定制(TUIRoomKit)
虚拟背景(TUIRoomKit)
会议控制(TUIRoomKit)
云端录制(TUIRoomKit)
AI 降噪(TUIRoomKit)
会中聊天(TUIRoomKit)
机器人推流(TUIRoomKit)
更多特性(TUIRoomKit)
客户端 API(TUIRoomKit)
服务端 API(TUIRoomKit)
常见问题(TUIRoomKit)
错误码 (TUIRoomKit)
SDK更新日志(TUIRoomKit)
直播与语聊 SDK
Live 视频直播计费说明
组件介绍
开通服务(TUILiveKit)
跑通 Demo
无 UI 集成
UI 自定义
直播监播
视频直播
语聊房
高级功能
客户端 API
服务端 API
错误码
发布日志
常见问题
RTC Engine
开通服务
SDK 下载
API-Example
接入指引
API-参考手册
高级功能
AI 集成
概述
MCP 配置
Skills 配置
集成指南
常见问题
RTC RESTFUL API
History
Introduction
API Category
Room Management APIs
Stream mixing and relay APIs
On-cloud recording APIs
Data Monitoring APIs
Pull stream Relay Related interface
Web Record APIs
AI Service APIs
Cloud Slicing APIs
Cloud Moderation APIs
Making API Requests
Call Quality Monitoring APIs
Usage Statistics APIs
Data Types
Appendix
Error Codes
控制台指南
应用管理
套餐包管理
用量统计
监控仪表盘
开发辅助
解决方案
实时合唱
常见问题
迁移指南
计费相关
功能相关
UserSig 相关
应对防火墙限制相关
缩减安装包体积相关
Andriod 与 iOS 相关
Web 端相关
Flutter 相关
Electron 相关
TRTCCalling Web 相关
音视频质量相关
其他问题
旧版文档
RTC RoomEngine SDK(旧)
集成 TUIRoom (Web)
集成 TUIRoom (Android)
集成 TUIRoom (iOS)
集成 TUIRoom (Flutter)
集成 TUIRoom (Electron)
TUIRoom API 查询
实现云端录制与回放(旧)
监控仪表盘计费(旧)
协议与策略
安全合规认证
安全白皮书
信息安全说明
服务等级协议
苹果隐私策略:PrivacyInfo.xcprivacy
TRTC 政策
隐私协议
数据处理和安全协议
词汇表

AudioEffectStore

PDF
聚焦模式
字号
最后更新时间: 2026-03-05 16:32:07

简介

AudioEffectStore 提供了一套完整的音效管理 API,包括变声效果、混响效果和耳返功能。
通过该类,主播可以在直播过程中实时调整自己的声音效果,提升直播体验。
重要:
使用 shared 单例获取 AudioEffectStore 实例。设置的音效在退出房间后会自动失效,下次进房需要重新设置。
说明:
音效状态更新通过 audioEffectState 发布者传递。订阅它以接收有关变声、混响和耳返状态的实时更新。
警告:
由于蓝牙耳机的硬件延迟非常高,在主播佩戴蓝牙耳机时无法开启耳返功能。请在用户界面上提示主播佩戴有线耳机。

功能特性

变声效果:支持多种变声特效,如熊孩子、小女孩、大叔等。
混响效果:支持多种混响特效,如KTV、小房间、大会堂等。
耳返功能:主播可在耳机中听到自己的声音,适用于唱歌场景。
音量控制:支持耳返音量的精细调节。

可订阅数据

AudioEffectState 的字段描述如下:
属性名
类型
描述
audioChangerType
ValueListenable<AudioChangerType>
变声状态。
audioReverbType
ValueListenable<AudioReverbType>
混响状态。
isEarMonitorOpened
ValueListenable<bool>
耳返开启。
earMonitorVolume
ValueListenable<int>
耳返音量,取值范围 0 - 100。 如果将 volume 设置成 100 之后感觉音量还是太小,可以将 volume 最大设置成 150,但超过 100 的 volume 会有爆音的风险,请谨慎操作。

API 列表

函数名
描述
获取单例实例。
设置变声效果。
设置混响效果。
开启/关闭耳返。
设置耳返音量。
重置为默认状态。

获取实例

shared

获取单例实例。

变声设置

setAudioChangerType

设置变声效果
void setAudioChangerType(AudioChangerType type);
通过该接口您可以设置人声的变声特效。 变声特效可以作用于人声之上,通过声学算法对人声进行二次处理,以获得与原始声音所不同的音色。
版本信息
从 3.5 版本开始支持。
调用时机
进入房间后,且需要使用变声效果时调用。
注意事项
说明:
设置的效果在退出房间后会自动失效,如果下次进房还需要对应特效,需要调用此接口再次进行设置。
参数说明
参数名
类型
是否必填
描述
type
必填
变声效果类型。

混响设置

setAudioReverbType

设置混响效果
void setAudioReverbType(AudioReverbType type);
通过该接口您可以设置人声的混响效果。 混响特效可以作用于人声之上,通过声学算法对声音进行叠加处理,模拟出各种不同环境下的临场感受。
版本信息
从 3.5 版本开始支持。
调用时机
进入房间后,且需要使用混响效果时调用。
注意事项
说明:
设置的效果在退出房间后会自动失效,如果下次进房还需要对应特效,需要调用此接口再次进行设置。
参数说明
参数名
类型
是否必填
描述
type
必填
混响效果类型。

耳返设置

setVoiceEarMonitorEnable

开启/关闭耳返
void setVoiceEarMonitorEnable(bool enable);
主播开启耳返后,可以在耳机里听到麦克风采集到的自己发出的声音,该特效适用于主播唱歌的应用场景中。
版本信息
从 3.5 版本开始支持。
适用场景
适用于主播唱歌场景,让主播能够实时听到自己的声音以便调整演唱效果。
调用时机
进入房间后,且主播佩戴有线耳机时调用。
注意事项
警告:
由于蓝牙耳机的硬件延迟非常高,所以在主播佩戴蓝牙耳机时无法开启此特效,请尽量在用户界面上提示主播佩戴有线耳机。
参数说明
参数名
类型
是否必填
描述
enable
bool
必填
是否开启耳返。

setVoiceEarMonitorVolume

设置耳返音量
void setVoiceEarMonitorVolume(int volume);
通过该接口您可以设置耳返特效中声音的音量大小。
版本信息
从 3.5 版本开始支持。
调用时机
开启耳返功能后调用。
注意事项
说明:
如果将 volume 设置成 100 之后感觉音量还是太小,可以将 volume 最大设置成 150,但超过 100 的 volume 会有爆音的风险,请谨慎操作。
参数说明
参数名
类型
是否必填
描述
volume
int
必填
耳返音量。(取值范围:0 - 100(超过 100 可能导致爆音))(默认值:100)。

重置

reset

重置为默认状态
void reset();
将所有音效设置重置为默认值,包括关闭变声效果、关闭混响效果、关闭耳返并重置耳返音量。
版本信息
从 3.5 版本开始支持。
调用时机
需要恢复默认音效设置时调用,例如退出直播间前。

数据结构

AudioChangerType

变声效果类型。
枚举值
说明
none
0
关闭特效。
child
1
熊孩子。
littleGirl
2
小女孩。
man
3
大叔。
heavyMetal
4
重金属。
cold
5
感冒。
foreigner
6
外语腔。
trappedBeast
7
困兽。
fatso
8
肥宅。
strongCurrent
9
强电流。
heavyMachinery
10
重机械。
ethereal
11
空灵。

AudioReverbType

混响效果类型。
枚举值
说明
none
0
关闭特效。
ktv
1
KTV。
smallRoom
2
小房间。
auditorium
3
大会堂。
deep
4
低沉。
loud
5
洪亮。
metallic
6
金属声。
magnetic
7
磁性。

AudioEffectState

AudioEffectStore 对外提供的音效相关状态数据。
属性
类型
说明
audioChangerType
ValueListenable<AudioChangerType>
变声状态。
audioReverbType
ValueListenable<AudioReverbType>
混响状态。
isEarMonitorOpened
ValueListenable<bool>
耳返开启。
earMonitorVolume
ValueListenable<int>
耳返音量,取值范围 0 - 100。 如果将 volume 设置成 100 之后感觉音量还是太小,可以将 volume 最大设置成 150,但超过 100 的 volume 会有爆音的风险,请谨慎操作。

使用示例

// 获取单例实例
final store = AudioEffectStore.shared;

// 订阅状态变化
store.audioEffectState.audioChangerType.addListener(() {
print("当前变声效果: ${store.audioEffectState.audioChangerType.value}");
});

store.audioEffectState.audioReverbType.addListener(() {
print("当前混响效果: ${store.audioEffectState.audioReverbType.value}");
});

// 设置变声效果
store.setAudioChangerType(AudioChangerType.littleGirl);

// 设置混响效果
store.setAudioReverbType(AudioReverbType.ktv);

// 开启耳返
store.setVoiceEarMonitorEnable(true);
store.setVoiceEarMonitorVolume(80);


帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈