调整通话音量 | 声网文档中心

本文介绍如何设置音频采集和播放、以及耳返播放的音量。为了更好地理解这些操作，你需要先了解以下与通话音量相关的基础概念：

采集是指音频信号经由采集设备采集后，传输到发送端的过程。
播放是指音频信号从接收端传输到播放设备后，通过播放设备进行播放的过程。
耳返是指将采集到的音频信号实时回传并通过耳机播放的过程。

技术原理

声网 SDK 支持对 SDK 采集和播放的音频音量进行调整，以满足用户实际应用场景。例如，进行双人通话时，需要静音远端用户，可以通过调整播放音量的方法将音量设置为 0。下图展示了调整音量的工作流程：

①：调用 adjustRecordingSignalVolume 调节音频采集信号音量。
②：调用 setInEarMonitoringVolume 设置耳返音量。
③：调用 adjustUserPlaybackSignalVolume 调节本地播放的指定远端用户信号音量。
④：调用 adjustPlaybackSignalVolume 调节本地播放的所有远端用户信号音量。

注意

如果使用调整信号音量的方法将音量设置过大，在某些设备上可能会出现音频失真。

前提条件

在实现调整通话音量前，请确保已在你的项目中实现基本的实时音视频功能。详见实现音视频互动。

实现方法

调整播放音量

调用 adjustPlaybackSignalVolume 或 adjustUserPlaybackSignalVolume 调整音频播放信号的音量。

Java

int volume = 50;
int uid = 123456;
// 设置本地播放的所有远端用户音量
mRtcEngine.adjustPlaybackSignalVolume(volume);
// 设置本地播放的指定远端用户的音量，例如用户 123456
mRtcEngine.adjustUserPlaybackSignalVolume(uid, volume);

调整耳返音量

在音频采集、混音、播放的整个过程中，你都可以调用 setInEarMonitoringVolume 调整耳返的音量。

Java

// 开启耳返功能
rtcEngine.enableInEarMonitoring(true);
int volume = 50;
// 调整耳返音量
rtcEngine.setInEarMonitoringVolume(volume);

获取用户音量（回调）

在音频采集、混音、播放的整个过程中，你都可以通过 onAudioVolumeIndication 回调获取频道内瞬时音量最高的三个用户（即说话者）的用户 ID 及他们的音量。返回的 uid 为 0 表示本地用户。

注意

你需要开启 enableAudioVolumeIndication 方法才能收到该回调。

Java

private final IRtcEngineEventHandler mRtcEventHandler = new IRtcEngineEventHandler() {

      ...

      @override
      public void onAudioVolumeIndication(AudioVolumeInfo[] speakers, int totalVolume) {
      // 获取瞬时说话音量最高的三个用户（即说话者）的用户 ID、他们的音量及本地用户是否在说话
      }
};

...

// 启用 onAudioVolumeIndication 回调
mRtcEngine.enableAudioVolumeIndication(1000, 3, true);

调整采集音量

调用 adjustRecordingSignalVolume 调整音频采集信号的音量。

Java

ChannelMediaOptions options = new ChannelMediaOptions();
options.clientRoleType = Constants.CLIENT_ROLE_BROADCASTER;
mRtcEngine.joinChannel(token, channelName, 1234, options);
int volume = 50;
// 调整采集信号音量
rtcEngine.adjustRecordingSignalVolume(volume);

注意事项

使用采集设备采集音频信号时，SDK 默认使用采集设备音量为 85。音量 0 代表静音，音量 255 代表设备的最大音量。如果 SDK 检测到采集设备音量在当前环境中过低，SDK 会自动提高采集设备音量。采集设备音量影响设备的全局音量。如果采集设备音量无法满足你的需求，你可以通过调节麦克风或声卡采集的信号幅度，从而调节采集音量。

参考信息

示例项目

声网提供了调整采集、播放、耳返音量的开源示例项目供你参考，你可以前往下载或查看其中的源代码。

JoinChannelAudio（Gitee）

JoinChannelAudio（GitHub）

参考文档

实现调整通话音量过程中，你还可以参考如下文档：

如何处理音量太小问题？

API 参考

本文介绍如何设置音频采集和播放、以及耳返播放的音量。为了更好地理解这些操作，你需要先了解以下与通话音量相关的基础概念：

采集是指音频信号经由采集设备采集后，传输到发送端的过程。
播放是指音频信号从接收端传输到播放设备后，通过播放设备进行播放的过程。
耳返是指将采集到的音频信号实时回传并通过耳机播放的过程。

技术原理

①：调用 adjustRecordingSignalVolume 调节音频采集信号音量。
②：调用 setInEarMonitoringVolume 设置耳返音量。
③：调用 adjustUserPlaybackSignalVolume 调节本地播放的指定远端用户信号音量。
④：调用 adjustPlaybackSignalVolume 调节本地播放的所有远端用户信号音量。

注意

如果使用调整信号音量的方法将音量设置过大，在某些设备上可能会出现音频失真。

前提条件

在实现调整通话音量前，请确保已在你的项目中实现基本的实时音视频功能。详见实现音视频互动。

实现方法

调整播放音量

调用 adjustPlaybackSignalVolume 或 adjustUserPlaybackSignalVolume 调整音频播放信号的音量。

Objective-C

// 设置本地播放的所有远端用户音量
[agoraKit adjustPlaybackSignalVolume: 50];
// 设置本地播放的指定远端用户的音量
[agoraKit adjustUserPlaybackSignalVolume: uid, volume: 50];

Swift

// 设置本地播放的所有远端用户音量
agoraKit.adjustPlaybackSignalVolume(50)
// 设置本地播放的指定远端用户的音量
agoraKit.adjustUserPlaybackSignalVolume(uid, volume: 50)

调整耳返音量

在音频采集、混音、播放的整个过程中，你都可以调用 setInEarMonitoringVolume 调整耳返的音量。

Objective-C

// 开启耳返功能
[agoraKit enableInEarMonitoring(true)];
// 调整耳返音量
[agoraKit setInEarMonitoringVolume: 50];

Swift

// 开启耳返功能
agoraKit.enableInearMonitoring(true)
// 调整耳返音量
agoraKit.setInEarMonitoringVolume(50)

获取用户音量（回调）

在音频采集、混音、播放的整个过程中，你都可以通过 reportAudioVolumeIndicationOfSpeakers 回调获取频道内瞬时音量最高的三个用户（即说话者）的用户 ID 及他们的音量。返回的 uid 为 0 表示本地用户。

注意

你需要开启 enableAudioVolumeIndication 方法才能收到该回调。

Objective-C

// 获取瞬时说话音量最高的三个用户（即说话者）的用户 ID、他们的音量及本地用户是否在说话
- (void)rtcEngine:(AgoraRtcEngineKit *_Nonnull)engine   reportAudioVolumeIndicationOfSpeakers:(NSArray<AgoraRtcAudioVolumeInfo*> *_Nonnull)  speakers totalVolume:(NSInteger)totalVolume {
}

Swift

// 获取瞬时说话音量最高的三个用户（即说话者）的用户 ID、他们的音量及本地用户是否在说话
func rtcEngine(_ engine: AgoraRtcEngineKit, reportAudioVolumeIndicationOfSpeakers speakers:
[AgoraRtcAudioVolumeInfo], totalVolume: Int) {
}

// 启用用户音量提示
agoraKit.enableAudioVolumeIndication(200, smooth: 3, reportVad: true)

调整采集音量

调用 adjustRecordingSignalVolume 调整音频采集信号的音量。

Objective-C

// 调整采集信号音量
[agoraKit adjustRecordingSignalVolume: 50];

Swift

// 调整采集信号音量
agoraKit.adjustRecordingSignalVolume(50)

注意事项

参考信息

示例项目

声网提供了调整采集、播放、耳返音量的开源示例项目供你参考，你可以前往下载或查看其中的源代码。

JoinChannelAudio（Gitee）

JoinChannelAudio（GitHub）

如需调整混音或音效文件的播放音量，可以参考以下示例项目。

AudioMixing（Gitee）

AudioMixing（GitHub）

参考文档

实现调整通话音量过程中，你还可以参考如下文档：

如何处理音量太小问题？

API 参考

本文介绍如何设置音频采集和播放、以及耳返播放的音量。为了更好地理解这些操作，你需要先了解以下与通话音量相关的基础概念：

采集是指音频信号经由采集设备采集后，传输到发送端的过程。
播放是指音频信号从接收端传输到播放设备后，通过播放设备进行播放的过程。
耳返是指将采集到的音频信号实时回传并通过耳机播放的过程。

技术原理

①：调用 adjustRecordingSignalVolume 调节音频采集信号音量。
②：调用 setInEarMonitoringVolume 设置耳返音量。
③：调用 adjustUserPlaybackSignalVolume 调节本地播放的指定远端用户信号音量。
④：调用 adjustPlaybackSignalVolume 调节本地播放的所有远端用户信号音量。

注意

如果使用调整信号音量的方法将音量设置过大，在某些设备上可能会出现音频失真。

前提条件

在实现调整通话音量前，请确保已在你的项目中实现基本的实时音视频功能。详见实现音视频互动。

实现方法

调整播放音量

调用 setDeviceVolume 调整播放设备音量。volume 的值与 macOS 系统中音频设备属性里的值是一一对应的，255 对应下图中喇叭/耳机的音量值调到最右。

Objective-C

// 调整播放设备音量为 50
[agoraKit setDeviceVolume: AgoraMediaDeviceTypeAudioPlayout volume: 50];

Swift

// 调整播放设备音量为 50
agoraKit.setDeviceVolume(.audioPlayout, volume: 50)

调用 adjustPlaybackSignalVolume 或 adjustUserPlaybackSignalVolume 调整音频播放信号的音量。

Objective-C

// 设置本地播放的所有远端用户音量
[agoraKit adjustPlaybackSignalVolume: 50];
// 设置本地播放的指定远端用户的音量
[agoraKit adjustUserPlaybackSignalVolume: uid, volume: 50];

Swift

// 设置本地播放的所有远端用户音量
agoraKit.adjustPlaybackSignalVolume(50)
// 设置本地播放的指定远端用户的音量
agoraKit.adjustUserPlaybackSignalVolume(uid, volume: 50)

获取用户音量（回调）

注意

你需要开启 enableAudioVolumeIndication 方法才能收到该回调。

Objective-C

// 获取瞬时说话音量最高的三个用户（即说话者）的用户 ID、他们的音量及本地用户是否在说话
- (void)rtcEngine:(AgoraRtcEngineKit *_Nonnull)engine   reportAudioVolumeIndicationOfSpeakers:(NSArray<AgoraRtcAudioVolumeInfo*> *_Nonnull)  speakers totalVolume:(NSInteger)totalVolume {
}

Swift

// 获取瞬时说话音量最高的三个用户（即说话者）的用户 ID、他们的音量及本地用户是否在说话
func rtcEngine(_ engine: AgoraRtcEngineKit, reportAudioVolumeIndicationOfSpeakers speakers:
[AgoraRtcAudioVolumeInfo], totalVolume: Int) {
}

// 启用用户音量提示
agoraKit.enableAudioVolumeIndication(200, smooth: 3, reportVad: true)

调整采集音量

调用 setDeviceVolume 调整采集设备音量。volume 的值与 macOS 系统中音频设备属性里的值是一一对应的，255 对应下图中麦克风阵列的音量值调到最右。

Objective-C

// 调整采集设备音量为 50
[agoraKit setDeviceVolume: AgoraMediaDeviceTypeAudioRecording volume: 50];

Swift

// 调整采集设备音量为 50
agoraKit.setDeviceVolume(.audioRecording, volume: 50)

调用 adjustRecordingSignalVolume 调整音频采集信号的音量。

Objective-C

// 调整采集信号音量
[agoraKit adjustRecordingSignalVolume: 50];

Swift

// 调整采集信号音量
agoraKit.adjustRecordingSignalVolume(50)

注意事项

使用采集设备采集音频信号时，SDK 默认使用采集设备音量为 85。音量 0 代表静音，音量 255 代表设备的最大音量。如果 SDK 检测到采集设备音量在当前环境中过低，SDK 会自动提高采集设备音量。采集设备音量影响设备的全局音量。如果采集设备音量无法满足你的需求，你可以通过调节麦克风或声卡采集的信号幅度来调整采集音量。

参考信息

示例项目

声网提供了调整采集、播放、耳返音量的开源示例项目供你参考，你可以前往下载或查看其中的源代码。

JoinChannelAudio（Gitee）

JoinChannelAudio（GitHub）

如需调整混音或音效文件的播放音量，可以参考以下示例项目。

AudioMixing（Gitee）

AudioMixing（GitHub）

参考文档

实现调整通话音量过程中，你还可以参考如下文档：

如何处理音量太小问题？

API 参考

在使用声网 Web SDK 时，你可以对 SDK 采集到的声音及 SDK 播放的声音音量进行调整，以满足产品在声音上的个性化需求。比如进行双人通话时，可以通过这个功能调整麦克风采集音量或者远端用户音量。

前提条件

开始前，请确保你已参考快速开始在你的项目中实现基本的实时音视频功能。

实现方法

SDK 为本地音频轨道和远端音频轨道对象分别提供 setVolume 方法用于调整本地音频的采集音量和远端音频的播放音量。

调节远端音频的播放音量

以下示例中 remoteUser 是指已订阅的远端用户对象。

JavaScript

// 将音量减少一半
remoteUser.audioTrack.setVolume(50);
// 使用原始音量
remoteUser.audioTrack.setVolume(100);
// 将远端音量设置为 0
remoteUser.audioTrack.setVolume(0);

调节本地音频的采集音量

以下示例中 localAudioTrack 是指自己创建的本地音频轨道对象。

JavaScript

AgoraRTC.createMicrophoneAudioTrack().then(localAudioTrack => {
  // 麦克风音量减半
  localAudioTrack.setVolume(50);
  // 麦克风音量增大一倍
  localAudioTrack.setVolume(200);
  // 将麦克风音量设置为 0
  localAudioTrack.setVolume(0);
});

参考信息

开发注意事项

音量设置太大在某些设备上可能出现爆音现象。

API 参考

本文介绍如何设置音频采集和播放、以及耳返播放的音量。为了更好地理解这些操作，你需要先了解以下与通话音量相关的基础概念：

采集是指音频信号经由采集设备采集后，传输到发送端的过程。
播放是指音频信号从接收端传输到播放设备后，通过播放设备进行播放的过程。
耳返是指将采集到的音频信号实时回传并通过耳机播放的过程。

技术原理

①：调用 adjustRecordingSignalVolume 调节音频采集信号音量。
②：调用 setInEarMonitoringVolume 设置耳返音量。
③：调用 adjustUserPlaybackSignalVolume 调节本地播放的指定远端用户信号音量。
④：调用 adjustPlaybackSignalVolume 调节本地播放的所有远端用户信号音量。

注意

如果使用调整信号音量的方法将音量设置过大，在某些设备上可能会出现音频失真。

前提条件

在实现调整通话音量前，请确保已在你的项目中实现基本的实时音视频功能。详见实现音视频互动。

实现方法

调整播放音量

调用 adjustPlaybackSignalVolume 或 adjustUserPlaybackSignalVolume 调整音频播放信号的音量。

C++

// 设置本地播放的所有远端用户音量为 50
int vol = 50;
m_rtcEngine->adjustPlaybackSignalVolume(vol);
// 设置本地播放的指定远端用户的音量为 90
m_rtcEngine->adjustUserPlaybackSignalVolume(uid, 90);

获取用户音量（回调）

注意

你需要开启 enableAudioVolumeIndication 方法才能收到该回调。

C++

// 获取瞬时说话音量最高的三个用户（即说话者）的用户 ID、他们的音量及本地用户是否在说话
void CAudioVolumeEventHandler::onAudioVolumeIndication(const AudioVolumeInfo * speakers, unsigned int speakerNumber, int totalVolume){
}

// 启用 onAudioVolumeIndication 回调
m_rtcEngine->enableAudioVolumeIndication(1000, 0, true);

调整采集音量

调用 adjustRecordingSignalVolume 调整音频采集信号的音量。

C++

// 调整采集信号音量为 50
int vol = 50;
m_rtcEngine->adjustRecordingSignalVolume(vol);

注意事项

参考信息

示例项目

声网提供了调整采集、播放、耳返音量的开源示例项目供你参考，你可以前往下载或查看其中的源代码。

AudioVolume（Gitee）

AudioVolume（GitHub）

如需调整混音或音效文件的播放音量，可以参考以下示例项目。

AudioMixing（Gitee）

AudioMixing（GitHub）

AudioEffect（Gitee）

AudioEffect（GitHub）

参考文档

实现调整通话音量过程中，你还可以参考如下文档：

如何处理音量太小问题？

API 参考

本文介绍如何设置音频采集和播放、以及耳返播放的音量。为了更好地理解这些操作，你需要先了解以下与通话音量相关的基础概念：

采集是指音频信号经由采集设备采集后，传输到发送端的过程。
播放是指音频信号从接收端传输到播放设备后，通过播放设备进行播放的过程。
耳返是指将采集到的音频信号实时回传并通过耳机播放的过程。

技术原理

①：调用 adjustRecordingSignalVolume 调节音频采集信号音量。
②：调用 setInEarMonitoringVolume 设置耳返音量。
③：调用 adjustUserPlaybackSignalVolume 调节本地播放的指定远端用户信号音量。
④：调用 adjustPlaybackSignalVolume 调节本地播放的所有远端用户信号音量。

注意

如果使用调整信号音量的方法将音量设置过大，在某些设备上可能会出现音频失真。

前提条件

在实现调整通话音量前，请确保已在你的项目中实现基本的实时音视频功能。详见实现音视频互动。

实现方法

调整播放音量

调用 adjustPlaybackSignalVolume 或 adjustUserPlaybackSignalVolume 调整音频播放信号的音量。

ArkTS

let volume = 50;
let uid = 123456;
// 设置本地播放的所有远端用户音量
this.rtcEngine?.adjustPlaybackSignalVolume(volume);
// 设置本地播放的指定远端用户的音量，例如用户 123456
this.rtcEngine?.adjustUserPlaybackSignalVolume(uid, volume);

调整耳返音量

调用 enableInEarMonitoring 开启耳返功能后，在音频采集、混音、播放的整个过程中，你都可以调用 setInEarMonitoringVolume 调整耳返的音量。

ArkTS

// 开启耳返功能
this.rtcEngine?.enableInEarMonitoring(true, 1);
let volume = 50;
// 调整耳返音量
this.rtcEngine?.setInEarMonitoringVolume(volume);

获取用户音量（回调）

注意

你需要开启 enableAudioVolumeIndication 方法才能收到该回调。

ArkTS

let config: RtcEngineConfig = new RtcEngineConfig();
config.mEventHandler.onAudioVolumeIndication = (speakers: Array<AudioVolumeInfo>, totalVolume: number) => {
  Logger.info(TAG, `onAudioVolumeIndication totalVolume:${totalVolume} speakers:${JSON.stringify(speakers)}`)
};
this.rtcEngine = RtcEngine.create(config);
this.rtcEngine.enableAudioVolumeIndication(1000, 3, true);

调整采集音量

调用 adjustRecordingSignalVolume 调整音频采集信号的音量。

ArkTS

let volume = 50;
// 调整采集信号音量
this.rtcEngine?.adjustRecordingSignalVolume(volume);

注意事项

技术原理

①：调用 adjustRecordingSignalVolume 调节音频采集信号音量。
②：调用 setInEarMonitoringVolume 设置耳返音量。
③：调用 adjustUserPlaybackSignalVolume 调节本地播放的指定远端用户信号音量。
④：调用 adjustPlaybackSignalVolume 调节本地播放的所有远端用户信号音量。

注意

如果使用调整信号音量的方法将音量设置过大，在某些设备上可能会出现音频失真。

前提条件

在实现调整通话音量前，请确保已在你的项目中实现基本的实时音视频功能。详见实现音视频互动。

实现方法

调整播放音量

调用 adjustPlaybackSignalVolume 或 adjustUserPlaybackSignalVolume 调整音频播放信号的音量。

TypeScript

//设置播放音量为50
engine.adjustPlaybackSignalVolume(50);
 
//指定uid为12的远端用户，音量设置为50
engine.adjustUserPlaybackSignalVolume(12, 50);

获取用户音量（回调）

注意

你需要开启 enableAudioVolumeIndication 方法才能收到该回调。

TypeScript

// 获取瞬时说话音量最高的三个用户（即说话者）的用户 ID、他们的音量及本地用户是否在说话
onAudioVolumeIndication?(
    connection: RtcConnection,
    speakers: AudioVolumeInfo[],
    speakerNumber: number,
    totalVolume: number
  ): void;

调整采集音量

调用 adjustRecordingSignalVolume 调整音频采集信号的音量。

TypeScript

// 调整采集信号音量为 50
engine.adjustRecordingSignalVolume(50);

注意事项

参考信息

示例项目

声网提供了调整采集、播放、耳返音量的开源示例项目供你参考，你可以前往下载或查看其中的源代码。

JoinChannelAudio（Gitee）

JoinChannelAudio（GitHub）

如需调整混音或音效文件的播放音量，可以参考以下示例项目。

AudioMixing（Gitee）

AudioMixing（GitHub）

参考文档

实现调整通话音量过程中，你还可以参考如下文档：

如何处理音量太小问题？

API 参考

本文介绍如何设置音频采集和播放、以及耳返播放的音量。为了更好地理解这些操作，你需要先了解以下与通话音量相关的基础概念：

采集是指音频信号经由采集设备采集后，传输到发送端的过程。
播放是指音频信号从接收端传输到播放设备后，通过播放设备进行播放的过程。
耳返是指将采集到的音频信号实时回传并通过耳机播放的过程。

技术原理

①：调用 AdjustRecordingSignalVolume 调节音频采集信号音量。
②：调用 SetInEarMonitoringVolume 设置耳返音量。
③：调用 AdjustUserPlaybackSignalVolume 调节本地播放的指定远端用户信号音量。
④：调用 AdjustPlaybackSignalVolume 调节本地播放的所有远端用户信号音量。

注意

如果使用调整信号音量的方法将音量设置过大，在某些设备上可能会出现音频失真。

前提条件

在实现调整通话音量前，请确保已在你的项目中实现基本的实时音视频功能。详见实现音视频互动。

实现方法

调整播放音量

调用 AdjustPlaybackSignalVolume 或 AdjustUserPlaybackSignalVolume 调整音频播放信号的音量。

// 设置本地播放的所有远端用户音量为 50
RtcEngine.AdjustPlaybackSignalVolume(50);

// 指定 uid 为 12 的远端用户在本地播放的音量为 50
RtcEngine.AdjustUserPlaybackSignalVolume(12, 50);

获取用户音量（回调）

在音频采集、混音、播放的整个过程中，你都可以通过 OnAudioVolumeIndication 回调获取频道内瞬时音量最高的三个用户（即说话者）的用户 ID 及他们的音量。返回的 uid 为 0 表示本地用户。

注意

你需要调用 EnableAudioVolumeIndication 方法启用用户音量提示后才能收到该回调。

RtcEngine = Agora.Rtc.RtcEngine.CreateAgoraRtcEngine();
UserEventHandler handler = new UserEventHandler(this);
RtcEngineContext context = new RtcEngineContext(
    _appID,
    0,
    CHANNEL_PROFILE_TYPE.CHANNEL_PROFILE_LIVE_BROADCASTING,
    AUDIO_SCENARIO_TYPE.AUDIO_SCENARIO_DEFAULT
);
RtcEngine.Initialize(context);

// 设置监听回调
RtcEngine.InitEventHandler(handler);

// 启用用户音量提示
RtcEngine.EnableAudioVolumeIndication(1, 1, true);

class UserEventHandler : IRtcEngineEventHandler
{
    // 该回调会根据你在 EnableAudioVolumeIndication 中设置的时间间隔触发，并报告频道内瞬时音量最高的三个用户
    public override void OnAudioVolumeIndication(
        RtcConnection connection,
        AudioVolumeInfo[] speakers,
        uint speakerNumber,
        int totalVolume
    ) { }
}

调整采集音量

调用 AdjustRecordingSignalVolume 调整音频采集信号的音量。

// 设置采集信号音量为 50
RtcEngine.AdjustRecordingSignalVolume(50);

注意事项

参考信息

示例项目

声网提供了调整采集、播放、耳返音量的开源示例项目供你参考，你可以前往下载或查看其中的源代码。

AudioMixing（Gitee）

AudioMixing（GitHub）

参考文档

实现调整通话音量过程中，你还可以参考如下示例项目及文档：

如何处理音量太小问题？

API 参考

本文介绍如何设置音频采集和播放、以及耳返播放的音量。为了更好地理解这些操作，你需要先了解以下与通话音量相关的基础概念：

采集是指音频信号经由采集设备采集后，传输到发送端的过程。
播放是指音频信号从接收端传输到播放设备后，通过播放设备进行播放的过程。
耳返是指将采集到的音频信号实时回传并通过耳机播放的过程。

技术原理

①：调用 adjustRecordingSignalVolume 调节音频采集信号音量。
②：调用 setInEarMonitoringVolume 设置耳返音量。
③：调用 adjustUserPlaybackSignalVolume 调节本地播放的指定远端用户信号音量。
④：调用 adjustPlaybackSignalVolume 调节本地播放的所有远端用户信号音量。

注意

如果使用调整信号音量的方法将音量设置过大，在某些设备上可能会出现音频失真。

前提条件

在实现调整通话音量前，请确保已在你的项目中实现基本的实时音视频功能。详见实现音视频互动。

实现方法

调整播放音量

调用 adjustPlaybackSignalVolume 或 adjustUserPlaybackSignalVolume 调整音频播放信号的音量。

Dart

const int volume = 50;
// 设置本地播放的所有远端用户音量为 50
await rtcEngine.adjustPlaybackSignalVolume(volume);
// 设置本地播放的指定远端用户的音量为 50
await rtcEngine.adjustUserPlaybackSignalVolume(uid: 1000, volume: volume);

获取用户音量（回调）

注意

你需要开启 enableAudioVolumeIndication 方法才能收到该回调。

Dart

// 获取瞬时说话音量最高的三个用户（即说话者）的用户 ID、他们的音量及本地用户是否在说话
rtcEngine.registerEventHandler(RtcEngineEventHandler(
onAudioVolumeIndication: (RtcConnection connection,
    List<AudioVolumeInfo> speakers, int speakerNumber, int totalVolume) {
  logSink.log(
    '[onAudioVolumeIndication] speakers: ${speakers.toString()}, speakerNumber: $speakerNumber, totalVolume: $totalVolume');
  }
));

调整采集音量

调用 adjustRecordingSignalVolume 调整音频采集信号的音量。

Dart

// 调整采集信号音量为 50
int vol = 50;
await _rtcEngine->adjustRecordingSignalVolume(vol);

参考信息

示例项目

声网提供了调整采集、播放、耳返音量的开源示例项目供你参考，你可以前往下载或查看其中的源代码。

join_channel_audio.dart（Gitee）

join_channel_audio.dart（GitHub）

如需调整混音或音效文件的播放音量，可以参考以下示例项目。

audio_effect_mixing.dart（Gitee）

audio_effect_mixing.dart（GitHub）

参考文档

实现调整通话音量过程中，你还可以参考如下文档：

如何处理音量太小问题？

API 参考

本文介绍如何设置音频采集和播放、以及耳返播放的音量。为了更好地理解这些操作，你需要先了解以下与通话音量相关的基础概念：

采集是指音频信号经由采集设备采集后，传输到发送端的过程。
播放是指音频信号从接收端传输到播放设备后，通过播放设备进行播放的过程。
耳返是指将采集到的音频信号实时回传并通过耳机播放的过程。

技术原理

①：调用 adjustRecordingSignalVolume 调节音频采集信号音量。
②：调用 setInEarMonitoringVolume 设置耳返音量。
③：调用 adjustUserPlaybackSignalVolume 调节本地播放的指定远端用户信号音量。
④：调用 adjustPlaybackSignalVolume 调节本地播放的所有远端用户信号音量。

注意

如果使用调整信号音量的方法将音量设置过大，在某些设备上可能会出现音频失真。

前提条件

在实现调整通话音量前，请确保已在你的项目中实现基本的实时音视频功能。详见实现音视频互动。

实现方法

调整播放音量

调用 adjustPlaybackSignalVolume 或 adjustUserPlaybackSignalVolume 调整音频播放信号的音量。

TypeScript

//设置播放音量为50
engine.adjustPlaybackSignalVolume(50);
 
//指定uid为12的远端用户，音量设置为50
engine.adjustUserPlaybackSignalVolume(12, 50);

获取用户音量（回调）

注意

你需要开启 enableAudioVolumeIndication 方法才能收到该回调。

TypeScript

// 获取瞬时说话音量最高的三个用户（即说话者）的用户 ID、他们的音量及本地用户是否在说话
onAudioVolumeIndication?(
    connection: RtcConnection,
    speakers: AudioVolumeInfo[],
    speakerNumber: number,
    totalVolume: number
  ): void;

调整采集音量

调用 adjustRecordingSignalVolume 调整音频采集信号的音量。

TypeScript

// 调整采集信号音量为 50
engine.adjustRecordingSignalVolume(50);

注意事项

参考信息

示例项目

声网提供了调整采集、播放、耳返音量的开源示例项目供你参考，你可以前往下载或查看其中的源代码。

JoinChannelAudio（Gitee）

JoinChannelAudio（GitHub）

如需调整混音或音效文件的播放音量，可以参考以下示例项目。

AudioMixing（Gitee）

AudioMixing（GitHub）

参考文档

实现调整通话音量过程中，你还可以参考如下文档：

如何处理音量太小问题？

API 参考

本文介绍如何设置音频采集和播放、以及耳返播放的音量。为了更好地理解这些操作，你需要先了解以下与通话音量相关的基础概念：

采集是指音频信号经由采集设备采集后，传输到发送端的过程。
播放是指音频信号从接收端传输到播放设备后，通过播放设备进行播放的过程。
耳返是指将采集到的音频信号实时回传并通过耳机播放的过程。

技术原理

①：调用 adjustRecordingSignalVolume 调节音频采集信号音量。
②：调用 setInEarMonitoringVolume 设置耳返音量。
③：调用 adjustUserPlaybackSignalVolume 调节本地播放的指定远端用户信号音量。
④：调用 adjustPlaybackSignalVolume 调节本地播放的所有远端用户信号音量。

注意

如果使用调整信号音量的方法将音量设置过大，在某些设备上可能会出现音频失真。

前提条件

在实现调整通话音量前，请确保已在你的项目中实现基本的实时音视频功能。详见实现音视频互动。

实现方法

调整播放音量

调用 adjustPlaybackSignalVolume 或 adjustUserPlaybackSignalVolume 调整音频播放信号的音量。

C++

// 设置本地播放的所有远端用户音量为 50
int vol = 50;
m_rtcEngine->adjustPlaybackSignalVolume(vol);
// 设置本地播放的指定远端用户的音量为 90
m_rtcEngine->adjustUserPlaybackSignalVolume(uid, 90);

获取用户音量（回调）

注意

你需要开启 enableAudioVolumeIndication 方法才能收到该回调。

C++

// 获取瞬时说话音量最高的三个用户（即说话者）的用户 ID、他们的音量及本地用户是否在说话
void CAudioVolumeEventHandler::onAudioVolumeIndication(const AudioVolumeInfo * speakers, unsigned int speakerNumber, int totalVolume){
}

// 启用 onAudioVolumeIndication 回调
m_rtcEngine->enableAudioVolumeIndication(1000, 0, true);

调整采集音量

调用 adjustRecordingSignalVolume 调整音频采集信号的音量。

C++

// 调整采集信号音量为 50
int vol = 50;
m_rtcEngine->adjustRecordingSignalVolume(vol);

注意事项

参考信息

示例项目

声网提供了开源的示例项目供你参考，你可以前往下载或查看其中的源代码。

Unreal C++ 示例项目

参考文档

实现调整通话音量过程中，你还可以参考如下文档：

如何处理音量太小问题？

API 参考

本文介绍如何设置音频采集和播放、以及耳返播放的音量。为了更好地理解这些操作，你需要先了解以下与通话音量相关的基础概念：

采集是指音频信号经由采集设备采集后，传输到发送端的过程。
播放是指音频信号从接收端传输到播放设备后，通过播放设备进行播放的过程。
耳返是指将采集到的音频信号实时回传并通过耳机播放的过程。

技术原理

①：调用 AdjustRecordingSignalVolume 调节音频采集信号音量。
②：调用 SetInEarMonitoringVolume 设置耳返音量。
③：调用 AdjustUserPlaybackSignalVolume 调节本地播放的指定远端用户信号音量。
④：调用 AdjustPlaybackSignalVolume 调节本地播放的所有远端用户信号音量。

注意

如果使用调整信号音量的方法将音量设置过大，在某些设备上可能会出现音频失真。

前提条件

在实现调整通话音量前，请确保已在你的项目中实现基本的实时音视频功能。详见实现音视频互动。

实现方法

调整播放音量

本小节介绍如何调用 AdjustPlaybackSignalVolume 调整音频播放信号的音量。

1. 创建 UMG

创建一个 Slider (滑块) 控件，命名为 Slider_PlaybackSignalVolume，供用户拖动音量条调节播放音量。在本示例中，设置最小值为 0 (静音)，最大值为 100 (原始音量)。如下图所示：

2. 绑定 UI 事件

创建 Bind Event to On Value Changed 节点，分别连接 Slider_PlaybackSignalVolume 控件和 OnPlaybackSignalVolumeValChanged 回调。当用户拖动音量条调节音频播放信号时，会触发 OnPlaybackSignalVolumeValChanged 回调。如下图所示：

3. 实现回调函数

创建 OnPlaybackSignalVolumeValChanged 回调函数，配置以下参数：

输入参数	数据类型	参数描述
`Value`	Float	播放音量。

触发该回调后，会获取并处理用户指定的播放音量、将该音量赋值给 Adjust Playback Signal Volume 的 Volume 参数，并调用 Adjust Playback Signal Volume 方法调节播放音量。如下图所示：

调整采集音量

本小节介绍如何调用 AdjustRecordingSignalVolume 调整音频采集信号的音量。

1. 创建 UMG

创建一个 Slider (滑块) 控件，命名为 Slider_RecordingSignalVolume，供用户滑动音量条调节采集音量。在本示例中，设置最小值为 0 (静音)，最大值为 100 (原始音量)。如下图所示：

2. 绑定 UI 事件

创建 Bind Event to On Value Changed 节点，分别连接 Slider_RecordingSignalVolume 控件和 OnRecordingSignalVolumeValChanged 回调。当用户拖动音量条调节音频采集信号时，会触发 OnRecordingSignalVolumeValChanged 回调。如下图所示：

3. 实现 UI 事件

创建 OnRecordingSignalVolumeValChanged 回调函数，配置以下参数：

输入参数	数据类型	参数描述
`Value`	Float	采集音量。

触发该回调后，会获取并处理用户指定的采集音量、将该音量赋值给 Adjust Recording Signal Volume 的 Volume 参数，并调用 Adjust Recording Signal Volume 方法调节采集音量。如下图所示：

创建 OnAudioVolumeIndication 回调函数，配置以下参数：

输入参数数据类型参数描述
speakers Structure 用户音量信息，详见 FAudioVolumeInfo。
totalVolume Integer 混音后的总音量。
表格内容超出当前宽度，可横向滚动查看更多列。
添加对 OnAudioVolumeIndication 回调的监听，如下图所示：

输入参数	数据类型	参数描述
`speakers`	Structure	用户音量信息，详见 `FAudioVolumeInfo`。
`totalVolume`	Integer	混音后的总音量。

按指定的时间间隔触发 OnAudioVolumeIndication 回调时，打印监听到的用户音量信息。如下图所示：

如何处理音量太小问题？

技术原理Copy Anchor Link

前提条件Copy Anchor Link

实现方法Copy Anchor Link

调整播放音量Copy Anchor Link

调整耳返音量Copy Anchor Link

获取用户音量（回调）Copy Anchor Link

调整采集音量Copy Anchor Link

注意事项Copy Anchor Link

参考信息Copy Anchor Link

示例项目Copy Anchor Link

JoinChannelAudio（Gitee）

JoinChannelAudio（GitHub）

参考文档Copy Anchor Link

API 参考Copy Anchor Link

技术原理

前提条件

实现方法

调整播放音量

调整耳返音量

获取用户音量（回调）

调整采集音量

注意事项

参考信息

示例项目

参考文档

API 参考