# 调整通话音量 (/zh-CN/realtime-media/rtc/build/audio/volume/flutter)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
本文介绍如何设置音频采集和播放、以及耳返播放的音量。为了更好地理解这些操作,你需要先了解以下与通话音量相关的基础概念:
- **采集**是指音频信号经由采集设备采集后,传输到发送端的过程。
- **播放**是指音频信号从接收端传输到播放设备后,通过播放设备进行播放的过程。
- **耳返**是指将采集到的音频信号实时回传并通过耳机播放的过程。
## 技术原理 [#技术原理-7]
声网 SDK 支持对 SDK 采集和播放的音频音量进行调整,以满足用户实际应用场景。例如,进行双人通话时,需要静音远端用户,可以通过调整播放音量的方法将音量设置为 0。下图展示了调整音量的工作流程:
- ①:调用 `adjustRecordingSignalVolume` 调节音频采集信号音量。
- ②:调用 `setInEarMonitoringVolume` 设置耳返音量。
- ③:调用 `adjustUserPlaybackSignalVolume` 调节本地播放的指定远端用户信号音量。
- ④:调用 `adjustPlaybackSignalVolume` 调节本地播放的所有远端用户信号音量。
:::warning[注意]
如果使用调整信号音量的方法将音量设置过大,在某些设备上可能会出现音频失真。
:::
## 前提条件 [#前提条件-8]
在实现调整通话音量前,请确保已在你的项目中实现基本的实时音视频功能。详见[实现音视频互动](/zh-CN/realtime-media/rtc/get-started/quick-start)。
## 实现方法 [#实现方法-8]
### 调整播放音量 [#调整播放音量-7]
调用 `adjustPlaybackSignalVolume` 或 `adjustUserPlaybackSignalVolume` 调整音频播放信号的音量。
```dart
const int volume = 50;
// 设置本地播放的所有远端用户音量为 50
await rtcEngine.adjustPlaybackSignalVolume(volume);
// 设置本地播放的指定远端用户的音量为 50
await rtcEngine.adjustUserPlaybackSignalVolume(uid: 1000, volume: volume);
```
### 获取用户音量(回调) [#获取用户音量回调-7]
在音频采集、混音、播放的整个过程中,你都可以通过 `onAudioVolumeIndication` 回调获取频道内瞬时音量最高的三个用户(即说话者)的用户 ID 及他们的音量。返回的 `uid` 为 0 表示本地用户。
:::warning[注意]
你需要开启 `enableAudioVolumeIndication` 方法才能收到该回调。
:::
```dart
// 获取瞬时说话音量最高的三个用户(即说话者)的用户 ID、他们的音量及本地用户是否在说话
rtcEngine.registerEventHandler(RtcEngineEventHandler(
onAudioVolumeIndication: (RtcConnection connection,
List speakers, int speakerNumber, int totalVolume) {
logSink.log(
'[onAudioVolumeIndication] speakers: ${speakers.toString()}, speakerNumber: $speakerNumber, totalVolume: $totalVolume');
}
));
```
### 调整采集音量 [#调整采集音量-7]
调用 `adjustRecordingSignalVolume` 调整音频采集信号的音量。
```dart
// 调整采集信号音量为 50
int vol = 50;
await _rtcEngine->adjustRecordingSignalVolume(vol);
```
## 参考信息 [#参考信息-7]
### 示例项目 [#示例项目-7]
声网提供了调整采集、播放、耳返音量的开源示例项目供你参考,你可以前往下载或查看其中的源代码。
join_channel_audio.dart} href="https://gitee.com/agoraio-community/Agora-Flutter-SDK/blob/main/example/lib/examples/basic/join_channel_audio/join_channel_audio.dart" />
join_channel_audio.dart} href="https://github.com/AgoraIO-Extensions/Agora-Flutter-SDK/blob/main/example/lib/examples/basic/join_channel_audio/join_channel_audio.dart" />
如需调整混音或音效文件的播放音量,可以参考以下示例项目。
audio_effect_mixing.dart} href="https://gitee.com/agoraio-community/Agora-Flutter-SDK/blob/main/example/lib/examples/advanced/audio_effect_mixing/audio_effect_mixing.dart" />
audio_effect_mixing.dart} href="https://github.com/AgoraIO-Extensions/Agora-Flutter-SDK/blob/main/example/lib/examples/advanced/audio_effect_mixing/audio_effect_mixing.dart" />
### 参考文档 [#参考文档-7]
实现调整通话音量过程中,你还可以参考如下文档:
- [如何处理音量太小问题?](/zh-CN/reference/faq/quality/audio_low)
### API 参考 [#api-参考-8]
- [`adjustRecordingSignalVolume`](/zh-CN/api-reference/rtc/flutter/audio/audio-capture#api_irtcengine_adjustrecordingsignalvolume)
- [`adjustPlaybackSignalVolume`](/zh-CN/api-reference/rtc/flutter/audio/audio-basic#api_irtcengine_adjustplaybacksignalvolume)
- [`adjustUserPlaybackSignalVolume`](/zh-CN/api-reference/rtc/flutter/audio/audio-basic#api_irtcengine_adjustuserplaybacksignalvolume)
- [`adjustAudioMixingPlayoutVolume`](/zh-CN/api-reference/rtc/flutter/play/audio-mixing#api_irtcengine_adjustaudiomixingplayoutvolume)
- [`onAudioVolumeIndication`](/zh-CN/api-reference/rtc/flutter/audio/audio-basic#callback_irtcengineeventhandler_onaudiovolumeindication)