# 调整通话音量 (/zh-CN/realtime-media/rtc/build/audio/volume/macos) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 本文介绍如何设置音频采集和播放、以及耳返播放的音量。为了更好地理解这些操作,你需要先了解以下与通话音量相关的基础概念: - **采集**是指音频信号经由采集设备采集后,传输到发送端的过程。 - **播放**是指音频信号从接收端传输到播放设备后,通过播放设备进行播放的过程。 - **耳返**是指将采集到的音频信号实时回传并通过耳机播放的过程。 ## 技术原理 [#技术原理-2] 声网 SDK 支持对 SDK 采集和播放的音频音量进行调整,以满足用户实际应用场景。例如,进行双人通话时,需要静音远端用户,可以通过调整播放音量的方法将音量设置为 0。下图展示了调整音量的工作流程: - ①:调用 `adjustRecordingSignalVolume` 调节音频采集信号音量。 - ②:调用 `setInEarMonitoringVolume` 设置耳返音量。 - ③:调用 `adjustUserPlaybackSignalVolume` 调节本地播放的指定远端用户信号音量。 - ④:调用 `adjustPlaybackSignalVolume` 调节本地播放的所有远端用户信号音量。 :::warning[注意] 如果使用调整信号音量的方法将音量设置过大,在某些设备上可能会出现音频失真。 ::: ## 前提条件 [#前提条件-2] 在实现调整通话音量前,请确保已在你的项目中实现基本的实时音视频功能。详见[实现音视频互动](/zh-CN/realtime-media/rtc/get-started/quick-start)。 ## 实现方法 [#实现方法-2] ### 调整播放音量 [#调整播放音量-2] - 调用 `setDeviceVolume` 调整播放设备音量。`volume` 的值与 macOS 系统中音频设备属性里的值是一一对应的,255 对应下图中喇叭/耳机的音量值调到最右。 ![macOS 播放设备音量设置示意图](https://web-cdn.agora.io/docs-files/1545124651243) ```objc tab="Objective-C" // 调整播放设备音量为 50 [agoraKit setDeviceVolume: AgoraMediaDeviceTypeAudioPlayout volume: 50]; ``` ```swift tab="Swift" // 调整播放设备音量为 50 agoraKit.setDeviceVolume(.audioPlayout, volume: 50) ``` - 调用 `adjustPlaybackSignalVolume` 或 `adjustUserPlaybackSignalVolume` 调整音频播放信号的音量。 ```objc tab="Objective-C" // 设置本地播放的所有远端用户音量 [agoraKit adjustPlaybackSignalVolume: 50]; // 设置本地播放的指定远端用户的音量 [agoraKit adjustUserPlaybackSignalVolume: uid, volume: 50]; ``` ```swift tab="Swift" // 设置本地播放的所有远端用户音量 agoraKit.adjustPlaybackSignalVolume(50) // 设置本地播放的指定远端用户的音量 agoraKit.adjustUserPlaybackSignalVolume(uid, volume: 50) ``` ### 获取用户音量(回调) [#获取用户音量回调-2] 在音频采集、混音、播放的整个过程中,你都可以通过 `reportAudioVolumeIndicationOfSpeakers` 回调获取频道内瞬时音量最高的三个用户(即说话者)的用户 ID 及他们的音量。返回的 `uid` 为 0 表示本地用户。 :::warning[注意] 你需要开启 `enableAudioVolumeIndication` 方法才能收到该回调。 ::: ```objc tab="Objective-C" // 获取瞬时说话音量最高的三个用户(即说话者)的用户 ID、他们的音量及本地用户是否在说话 - (void)rtcEngine:(AgoraRtcEngineKit *_Nonnull)engine reportAudioVolumeIndicationOfSpeakers:(NSArray *_Nonnull) speakers totalVolume:(NSInteger)totalVolume { } ``` ```swift tab="Swift" // 获取瞬时说话音量最高的三个用户(即说话者)的用户 ID、他们的音量及本地用户是否在说话 func rtcEngine(_ engine: AgoraRtcEngineKit, reportAudioVolumeIndicationOfSpeakers speakers: [AgoraRtcAudioVolumeInfo], totalVolume: Int) { } // 启用用户音量提示 agoraKit.enableAudioVolumeIndication(200, smooth: 3, reportVad: true) ``` ### 调整采集音量 [#调整采集音量-2] - 调用 `setDeviceVolume` 调整采集设备音量。`volume` 的值与 macOS 系统中音频设备属性里的值是一一对应的,255 对应下图中麦克风阵列的音量值调到最右。 ![macOS 采集设备音量设置示意图](https://web-cdn.agora.io/docs-files/1545124630783) ```objc tab="Objective-C" // 调整采集设备音量为 50 [agoraKit setDeviceVolume: AgoraMediaDeviceTypeAudioRecording volume: 50]; ``` ```swift tab="Swift" // 调整采集设备音量为 50 agoraKit.setDeviceVolume(.audioRecording, volume: 50) ``` - 调用 `adjustRecordingSignalVolume` 调整音频采集信号的音量。 ```objc tab="Objective-C" // 调整采集信号音量 [agoraKit adjustRecordingSignalVolume: 50]; ``` ```swift tab="Swift" // 调整采集信号音量 agoraKit.adjustRecordingSignalVolume(50) ``` ## 注意事项 [#注意事项-2] 使用采集设备采集音频信号时,SDK 默认使用采集设备音量为 85。音量 0 代表静音,音量 255 代表设备的最大音量。如果 SDK 检测到采集设备音量在当前环境中过低,SDK 会自动提高采集设备音量。采集设备音量影响设备的全局音量。如果采集设备音量无法满足你的需求,你可以通过调节麦克风或声卡采集的信号幅度来调整采集音量。 ## 参考信息 [#参考信息-2] ### 示例项目 [#示例项目-2] 声网提供了调整采集、播放、耳返音量的开源示例项目供你参考,你可以前往下载或查看其中的源代码。 JoinChannelAudio} href="https://gitee.com/agoraio-community/API-Examples/blob/main/macOS/APIExample/Examples/Basic/JoinChannelAudio/JoinChannelAudio.swift" /> JoinChannelAudio} href="https://github.com/Shengwang-Community/API-Examples/blob/main/macOS/APIExample/Examples/Basic/JoinChannelAudio/JoinChannelAudio.swift" /> 如需调整混音或音效文件的播放音量,可以参考以下示例项目。 AudioMixing} href="https://gitee.com/agoraio-community/API-Examples/tree/main/macOS/APIExample/Examples/Advanced/AudioMixing" /> AudioMixing} href="https://github.com/Shengwang-Community/API-Examples/tree/main/macOS/APIExample/Examples/Advanced/AudioMixing" /> ### 参考文档 [#参考文档-2] 实现调整通话音量过程中,你还可以参考如下文档: - [如何处理音量太小问题?](/zh-CN/reference/faq/quality/audio_low) ### API 参考 [#api-参考-2] - [`setDeviceVolume`](/zh-CN/api-reference/rtc/macos/device-management/common-device#api_irtcengine_setdevicevolume) - [`adjustRecordingSignalVolume`](/zh-CN/api-reference/rtc/macos/audio/audio-capture#api_irtcengine_adjustrecordingsignalvolume) - [`adjustPlaybackSignalVolume`](/zh-CN/api-reference/rtc/macos/audio/audio-basic#api_irtcengine_adjustplaybacksignalvolume) - [`adjustUserPlaybackSignalVolume`](/zh-CN/api-reference/rtc/macos/audio/audio-basic#api_irtcengine_adjustuserplaybacksignalvolume) - [`adjustAudioMixingPlayoutVolume`](/zh-CN/api-reference/rtc/macos/play/audio-mixing#api_irtcengine_adjustaudiomixingplayoutvolume) - [`reportAudioVolumeIndicationOfSpeakers`](/zh-CN/api-reference/rtc/macos/audio/audio-basic#callback_irtcengineeventhandler_onaudiovolumeindication)