文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>实时音视频>无 UI 集成>搭建视频直播>音效>音效（Android）

音效（Android）

最近更新时间：2025-11-12 17:54:22

我的收藏

本页目录：

本篇文档旨在指导您如何使用 AtomicXCore 框架中的 AudioEffectStore 和 DeviceStore 模块，为您的直播应用快速集成音效控制功能，包括麦克风音量、耳返监听，并添加多种趣味变声效果和混响效果。


核心功能

通过组合 AudioEffectStore 和 DeviceStore，您将能实现以下核心功能：
人声音量调节：控制本地音频上行的采集音量大小，即观众听到的您的声音大小。
耳返功能：允许主播或连麦用户通过耳机实时听到自己的声音，用于监听和矫正发音。
变声效果：提供多种趣味变声选项，例如萝莉、大叔、熊孩子等。
混响效果：模拟不同环境的声场效果，例如 KTV、金属声、低沉、洪亮等。

概念说明

核心概念
类型
核心职责与描述
AudioChangerType
enum class
变声效果枚举，例如，“小孩”，“男人”等。

AudioReverbType

enum class
混响效果枚举，例如，“ktv”，“礼堂”等。
AudioEffectState
data class
代表音效模块的当前状态，通常用于 UI 渲染。包括变声状态、混响状态、耳返开启状态、耳返音量。
AudioEffectStore
abstract class
代表音效模块单例数据管理类。通过它您可以调用修改音效接口，当您调用接口后，相应的 state 属性会自动更新，可以通过订阅这个 state 响应式数据来接收和监听状态更新。
DeviceState
data class
代表设备模块的当前状态，通常用于 UI 渲染。核心属性包括摄像头、麦克风的设备状态。
DeviceStore
abstract class
代表设备模块单例数据管理类。通过它您可以调用操作摄像头、麦克风接口，当您调用接口后，相应的state属性会自动更新，可以通过订阅这个 state 响应式数据来接收和监听状态更新。

实现步骤

步骤1：组件集成

请参考 快速接入 集成 AtomicXCore。

步骤2：获取 Store 实例

AudioEffectStore 和 DeviceStore是单例对象，您可以直接通过 shared 属性在项目的任何位置获取实例。您也可以参考 TUILiveKit 开源UI demo项目中的 AudioEffectPanel.kt 文件来了解完整的实现逻辑。
import io.trtc.tuikit.atomicxcore.api.device.AudioEffectStore
import io.trtc.tuikit.atomicxcore.api.device.DeviceStore

val audioEffectStore = AudioEffectStore.shared()
val deviceStore = DeviceStore.shared()

步骤3：实现耳返功能

耳返功能允许用户实时监听自己的麦克风声音，可以通过调用本节介绍的接口管理耳返功能。
注意：
耳返功能通常需要连接耳机才能正常工作。

实现方式:

1. 开关耳返：您可以使用Switch控件实现开关耳返功能。
2. 设置耳返音量值：您可以使用 SeekBar 控件实现左右拖动滑块来调节音量的功能，并将 SeekBar 的值映射成音量值，调用setOutputVolume(volume)。请注意，该接口接收的参数范围是 [0, 150]，所以您需要将 UI 控件的值（例如 UISlider 的 0 - 1.0）映射到 0 - 150 的范围。
3. 监听状态更新 UI：您可以订阅实时的耳返状态值更新 UI。

代码示例:

import io.trtc.tuikit.atomicxcore.api.device.AudioEffectStore
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch

// 1. 开启耳返（建议提示用户插入耳机）
audioEffectStore.setVoiceEarMonitorEnable(true)

// 2. 调节耳返音量
audioEffectStore.setVoiceEarMonitorVolume(80)

// 3. 关闭耳返
audioEffectStore.setVoiceEarMonitorEnable(false)

// 4. 监听状态
CoroutineScope(Dispatchers.Main).launch {
  audioEffectStore.audioEffectState.earMonitorVolume.collect {
    print("耳返音量: $it")
    //更新UI 显示数值
   }
}

setVoiceEarMonitorEnable 接口参数

参数名
类型
描述
enable
Boolean
是否开启耳返。
true：开启
false：关闭

setVoiceEarMonitorVolume 接口参数

参数名
类型
描述
volume
Int
耳返音量大小。
取值范围： [0, 150]
默认值：100

步骤4：实现人声音量调节

当主播希望调节自己的上行采集音量大小时，调用DeviceStore的setCaptureVolume(volume)方法传入音量值即可。

实现方式:

1. 设置采集音量值：您可以使用 SeekBar 控件实现左右拖动滑块来调节音量的功能，并将 SeekBar 的值映射成音量值后调用setCaptureVolume(80)。请注意，该接口接收的参数范围是 [0, 150]，所以您需要将 UI 控件的值（例如 SeekBar 的 0 - 150）映射到 0 - 150 的范围。
2. 监听状态更新 UI：您可以订阅实时的音量状态值更新 UI。

示例代码：

import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch
import io.trtc.tuikit.atomicxcore.api.device.AudioEffectStore
import io.trtc.tuikit.atomicxcore.api.device.DeviceStore

// 1. 调节音量
deviceStore.setCaptureVolume(80)

// 2. 监听数据变化
CoroutineScope(Dispatchers.Main).launch {
   deviceStore.deviceState.captureVolume.collect {
     //更新显示数值
     print("采集音量: $it")
   }
}

setCaptureVolume 接口参数

参数名
类型
描述
volume
Int
采集音量大小。
取值范围： [0, 150]
默认值：100

步骤5：实现变声效果

当主播希望改变自己的声音时，您可以调用 setAudioChangerType(type)方法，传入相应的Type 枚举值即可切换效果。

示例代码：

import io.trtc.tuikit.atomicxcore.api.device.AudioEffectStore
import io.trtc.tuikit.atomicxcore.api.device.AudioChangerType

// 示例：设置变声为“萝莉”
audioEffectStore.setAudioChangerType(AudioChangerType.LITTLE_GIRL)

// 示例：关闭变声
audioEffectStore.setAudioChangerType(AudioChangerType.NONE)

setAudioChangerType 接口参数

参数名
类型
描述
type
AudioChangerType
变声效果枚举。

步骤6：实现混响效果

当主播希望给自己的声音添加混响效果时，您可以调用setAudioReverbType(type) 方法，传入相应的Type 枚举值即可切换效果。
import io.trtc.tuikit.atomicxcore.api.device.AudioEffectStore
import io.trtc.tuikit.atomicxcore.api.device.AudioReverbType

// 示例：设置混响为“KTV”
audioEffectStore.setAudioReverbType(AudioReverbType.KTV)

// 示例：关闭混响
audioEffectStore.setAudioReverbType(AudioReverbType.NONE)

setAudioReverbType 接口参数

参数名
类型
描述
type
AudioReverbType
混响效果枚举。

步骤7：重置音效设置

重要：
AudioEffectStore 和 DeviceStore 是单例，这意味着音效和设备设置是全局生效的，如果您在当前直播间的设置不想影响到您创建的其他直播间，就需要在当前直播间结束的时候重置音效和设备设置。
以下两种情况您可能需要重置音效设置：
1. 当前直播间结束时，需要重置音效设置。
2. 您需要提供“一键恢复”的功能，可以通过调用 store 的reset() 方法实现。
import io.trtc.tuikit.atomicxcore.api.device.AudioEffectStore
import io.trtc.tuikit.atomicxcore.api.device.DeviceStore

// 一键重置所有变声和混响效果
AudioEffectStore.shared().reset()
DeviceStore.shared().reset()


API 文档

关于 AudioEffectStore 和 DeviceStore 及其相关类的所有公开接口、属性的详细信息，请参阅随 AtomicXCore 框架的官方 API 文档。
Store/Component
功能描述
API 文档
AudioEffectStore
音效管理：进行音效设置，并获取实时音效状态。
API 文档
DeviceStore
设备管理：进行摄像头、麦克风操作，并获取实时设备状态。
API 文档

常见问题

音效和设备接口的调用时机有没有要求？

没有限制。AudioEffectStore和DeviceStore 的设置是全局生效的，您可以在进入直播间之前或之后随时调用相关接口（例如设置变声、混响或耳返），设置会立即生效并被保留。

“人声音量” 和“耳返音量” 有什么区别？

这是一个非常重要且易混淆的概念，区别如下：
人声音量 (CaptureVolume)：通过 DeviceStore.setCaptureVolume() 设置。它决定了观众能听到的您的声音大小。
耳返音量 (EarMonitorVolume)：通过 AudioEffectStore.setVoiceEarMonitorVolume() 设置。它只决定了您自己在耳机里听到的监听声音大小，不会影响观众。

新创建的直播间为什么直接就有音效、或者出现音量很大、很小等问题？

AudioEffectStore和DeviceStore是单例，这意味着音效和设备设置是全局生效的，出现这种情况很可能是因为您之前设置过音效但是没有重置，需要在合适的地方调用reset()方法重置。

为什么我开启了“耳返”，但是听不到自己的声音？

请您按照以下步骤检查：
1. 是否插入耳机：耳返功能绝大多数情况下依赖耳机才能生效，请确保已连接有线或蓝牙耳机。
2. 音量是否为0：检查“耳返音量”是否被设置为了 0。
3. 麦克风是否开启：确认 DeviceStore 中的麦克风是开启状态（即已调用 openLocalMicrophone）。

变声效果 和混响效果 可以同时生效吗？

可以。AudioChangerType 和 AudioReverbType 是可以叠加生效的。例如，您可以同时设置 AudioChangerType.LITTLE_GIRL 变声和 AudioReverbType.KTV 混响。

中国站
目录