# 音频采集 (/zh-CN/api-reference/rtc/ios/audio/audio-capture) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ## adjustRecordingSignalVolume: [#adjustrecordingsignalvolume] 调节采集音量。 ```objc - (int)adjustRecordingSignalVolume:(NSInteger)volume NS_SWIFT_NAME(adjustRecordingSignalVolume(_:)); ``` 如果你只需要静音音频信号,声网建议使用 [muteRecordingSignal:](/zh-CN/api-reference/rtc/ios/audio/audio-capture#api_irtcengine_muterecordingsignal) 方法。 ### 调用时机 [#调用时机] 该方法可以在加入频道前或后调用。 ### 参数 [#参数] 用户的音量。取值范围为 [0,400]。 - 0:静音。 - 100:(默认)原始音量。 - 400:原始音量的四倍(将音频信号放大四倍)。 ### 返回值 [#返回值] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类] - [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine) ## enableInEarMonitoring: [#enableinearmonitoring] 启用或关闭耳返监听功能。 ```objc - (int)enableInEarMonitoring:(BOOL)enabled NS_SWIFT_NAME(enable(inEarMonitoring:)); ``` 你可以调用该方法启用或关闭耳返监听功能。 :::note 注: [enableInEarMonitoring:](/zh-CN/api-reference/rtc/ios/audio/audio-capture#api_irtcengine_enableinearmonitoring) 仅在使用有线或蓝牙耳机时有效。 ::: ### 调用时机 [#调用时机-1] 该方法可以在加入频道前或加入频道后调用。 ### 参数 [#参数-1] 是否启用耳返监听功能: - YES:启用耳返监听功能。 - NO:(默认)关闭耳返监听功能。 ### 返回值 [#返回值-1] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 - -8:请确保当前音频路由为蓝牙或耳机。 ### 所属接口类 [#所属接口类-1] - [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine) ## enableInEarMonitoring\:includeAudioFilters: [#enableinearmonitoringincludeaudiofilters] 启用或关闭耳返监听功能。 ```objc - (int)enableInEarMonitoring:(BOOL)enabled includeAudioFilters:(AgoraEarMonitoringFilterType)includeAudioFilters NS_SWIFT_NAME(enable(inEarMonitoring:includeAudioFilters:)); ``` :::note 注: 你必须使用有线或蓝牙耳机才能听到耳返监听效果。 ::: ### 调用时机 [#调用时机-2] 该方法可以在加入频道前或加入频道后调用。 ### 参数 [#参数-2] 是否启用耳返监听功能。 - YES:启用耳返监听。 - NO:(默认)关闭耳返监听。 耳返监听的音频滤波器类型,详见 [AgoraEarMonitoringFilterType](/zh-CN/api-reference/rtc/ios/enum-earmonitoringfiltertype)。 ### 返回值 [#返回值-2] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 - -8:请确保当前音频路由为蓝牙或有线耳机。 ### 所属接口类 [#所属接口类-2] - [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine) ## enableLocalAudio: [#enablelocalaudio] 启用或关闭本地音频采集功能。 ```objc - (int)enableLocalAudio:(BOOL)enabled NS_SWIFT_NAME(enableLocalAudio(_:)); ``` [enableLocalAudio:](/zh-CN/api-reference/rtc/ios/audio/audio-capture#api_irtcengine_enablelocalaudio) 方法用于启用或关闭本地音频采集功能。默认情况下,加入频道时会启用音频功能。调用该方法可以停止或重新启动本地音频采集。 该方法与 [muteLocalAudioStream:](/zh-CN/api-reference/rtc/ios/publishnsubscribe#api_irtcengine_mutelocalaudiostream) 的区别如下: - [enableLocalAudio:](/zh-CN/api-reference/rtc/ios/audio/audio-capture#api_irtcengine_enablelocalaudio):关闭或重新启用本地音频采集和处理。如果使用该方法关闭或重新启用本地音频采集,可能会导致远端音频播放出现短暂中断。 - [muteLocalAudioStream:](/zh-CN/api-reference/rtc/ios/publishnsubscribe#api_irtcengine_mutelocalaudiostream):仅停止或恢复发送本地音频流,不影响音频采集状态。 该方法不会影响接收远端音频流。将 `enabled` 设为 NO 适用于只接收远端音频而不发送本地音频的场景。你可以在加入频道前或加入频道后调用该方法。在加入频道前调用时,仅设置设备状态,加入频道后立即生效。 ### 适用场景 [#适用场景] `enableLocalAudio(false)` 适用于只接收远端音频流而不发送本地采集音频的场景。该方法不会影响接收远端音频流。 ### 调用时机 [#调用时机-3] 你可以在加入频道前或加入频道后调用该方法。在加入频道前调用时,仅设置设备状态,加入频道后立即生效。 ### 相关回调 [#相关回调] 成功调用该方法后,SDK 会触发 [rtcEngine\:localAudioStateChanged\:reason:](/zh-CN/api-reference/rtc/ios/audio/audio-basic#callback_irtcengineeventhandler_onlocalaudiostatechanged) 回调,报告 `AgoraAudioLocalStateStopped`(0)或 `AgoraAudioLocalStateRecording`(1)。 ### 参数 [#参数-3] - YES:(默认)重新启用本地音频功能,即启动本地音频采集设备(例如麦克风)。 - NO:关闭本地音频功能,即停止本地音频采集。 ### 返回值 [#返回值-3] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-3] - [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine) ## muteRecordingSignal: [#muterecordingsignal] 设置是否静音录制信号。 ```objc - (int)muteRecordingSignal:(BOOL)muted NS_SWIFT_NAME(muteRecordingSignal(_:)); ``` 如果你已经调用了 [adjustRecordingSignalVolume:](/zh-CN/api-reference/rtc/ios/audio/audio-capture#api_irtcengine_adjustrecordingsignalvolume) 方法调整了录制信号的音量,当你调用该方法并将参数设置为 YES 时,SDK 的行为如下: - 记录调整后的音量。 - 静音录制信号。 当你再次调用该方法并将参数设置为 NO 时,录制信号音量将恢复为静音前 SDK 记录的音量。 ### 调用时机 [#调用时机-4] 该方法可以在加入频道前或后调用。 ### 参数 [#参数-4] - YES:静音录制信号。 - NO:(默认)不静音录制信号。 ### 返回值 [#返回值-4] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-4] - [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine) ## setInEarMonitoringVolume: [#setinearmonitoringvolume] 设置耳返音量。 ```objc - (int)setInEarMonitoringVolume:(NSInteger)volume NS_SWIFT_NAME(setInEarMonitoringVolume(_:)); ``` ### 调用时机 [#调用时机-5] 该方法可以在加入频道前或加入频道后调用。 ### 参数 [#参数-5] 用户的音量。取值范围为 [0,400]。 - 0:静音。 - 100:(默认)原始音量。 - 400:原始音量的四倍(将音频信号放大四倍)。 ### 返回值 [#返回值-5] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 - -2:参数设置不合法,例如耳返音量超出有效范围(小于 0 或大于 400)。 ### 所属接口类 [#所属接口类-5] - [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/ios/rtc-interface-class#class_irtcengine)