# 音频采集 (/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)