# 音频采集 (/zh-CN/api-reference/rtc/android/4.6.0/audio/audio-capture)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
## adjustRecordingSignalVolume [#adjustrecordingsignalvolume]
调节采集音频信号的音量。
```java
public abstract int adjustRecordingSignalVolume(int volume);
```
如果你只需要静音音频信号,声网建议使用 [muteRecordingSignal](/zh-CN/api-reference/rtc/android/audio/audio-capture#api_irtcengine_muterecordingsignal) 方法。
### 调用时机 [#调用时机]
该方法可以在加入频道前或加入频道后调用。
### 参数 [#参数]
#### `volume` [#volume]
用户的音量,取值范围为 [0,400]:
- 0:静音。
- 100:(默认)原始音量。
- 400:原始音量的四倍(将音频信号放大四倍)。
### 返回值 [#返回值]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/realtime-media/rtc/reference/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类]
- [RtcEngine](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_irtcengine)
## enableInEarMonitoring [1/2] [#enableinearmonitoring-12]
启用或关闭耳返监听。
```java
public abstract int enableInEarMonitoring(boolean enabled);
```
:::info[注]
你必须使用有线或蓝牙耳机才能听到耳返监听效果。
:::
### 调用时机 [#调用时机-1]
该方法可以在加入频道前或加入频道后调用。
### 参数 [#参数-1]
#### `enabled` [#enabled]
是否启用耳返监听(默认值为 false ):
- true:启用耳返监听。
- false:关闭耳返监听。
### 返回值 [#返回值-1]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/realtime-media/rtc/reference/error-code)了解详情和解决建议。
- -8:请确保当前音频路由为蓝牙或有线耳机。
### 所属接口类 [#所属接口类-1]
- [RtcEngine](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_irtcengine)
## enableInEarMonitoring [2/2] [#enableinearmonitoring-22]
启用或关闭耳返监听功能。
```java
public abstract int enableInEarMonitoring(boolean enabled, int includeAudioFilters);
```
:::info[注]
你必须使用有线或蓝牙耳机才能听到耳返监听效果。
:::
### 调用时机 [#调用时机-2]
该方法可以在加入频道前或加入频道后调用。
### 参数 [#参数-2]
#### `enabled` [#enabled-1]
是否启用耳返监听功能。
- true:启用耳返监听。
- false:(默认)关闭耳返监听。
#### `includeAudioFilters` [#includeaudiofilters]
:::info[注]
该参数仅在 `enabled` 为 true 时生效。
:::
耳返监听的音频滤镜类型:
- EAR_MONITORING_FILTER_NONE (1 << 0):(1)耳返监听中不添加音频滤镜。
- EAR_MONITORING_FILTER_BUILT_IN_AUDIO_FILTERS (1 << 1):(2)在耳返监听中添加人声特效音频滤镜。如果你实现了美声、音效等功能,用户可以听到添加这些效果后的声音。该枚举值支持使用按位或运算符(|)组合使用。
- EAR_MONITORING_FILTER_NOISE_SUPPRESSION (1 << 2):(4)在耳返监听中添加降噪音频滤镜。该枚举值支持使用按位或运算符(|)组合使用。
- EAR_MONITORING_FILTER_REUSE_POST_PROCESSING_FILTER (1 << 15):复用发送端已处理的音频滤镜用于耳返监听。该枚举值可降低 CPU 使用率,但会增加耳返监听延迟,适用于对延迟不敏感但要求低 CPU 消耗的场景。该枚举值仅支持单独使用,选中后其他音频滤镜配置将自动失效。
### 返回值 [#返回值-2]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/realtime-media/rtc/reference/error-code)了解详情和解决建议。
- -8:请确保当前音频路由为蓝牙或有线耳机。
### 所属接口类 [#所属接口类-2]
- [RtcEngine](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_irtcengine)
## enableLocalAudio [#enablelocalaudio]
启用或关闭本地音频采集功能。
```java
public abstract int enableLocalAudio(boolean enabled);
```
[enableLocalAudio](/zh-CN/api-reference/rtc/android/audio/audio-capture#api_irtcengine_enablelocalaudio) 用于控制本地音频采集和处理的启用状态。调用该方法关闭或重新启用本地音频采集时,本地用户可能会听到远端音频播放中断。 该方法与 [muteLocalAudioStream](/zh-CN/api-reference/rtc/android/publish-and-subscribe#api_irtcengine_mutelocalaudiostream) 的区别如下:
- enableLocalAudio:控制本地音频采集和处理的启用状态。
- muteLocalAudioStream:仅控制是否发送本地音频流,不影响音频采集状态。
### 适用场景 [#适用场景]
`enableLocalAudio(false)` 适用于只接收远端音频流而不发送本地采集音频的场景。该方法不会影响接收远端音频流。
### 调用时机 [#调用时机-3]
你可以在加入频道前或加入频道后调用该方法。在加入频道前调用该方法仅设置设备状态,并在加入频道后立即生效。
### 相关回调 [#相关回调]
一旦本地音频功能被关闭或重新启用,SDK 会触发 [onLocalAudioStateChanged](/zh-CN/api-reference/rtc/android/audio/audio-basic#callback_irtcengineeventhandler_onlocalaudiostatechanged) 回调,报告 `LOCAL_AUDIO_STREAM_STATE_STOPPED` (0)或 `LOCAL_AUDIO_STREAM_STATE_RECORDING` (1)。
### 参数 [#参数-3]
#### `enabled` [#enabled-2]
是否启用本地音频功能:
- true:(默认)重新启用本地音频功能,即启动本地音频采集设备(如麦克风)。
- false:关闭本地音频功能,即停止本地音频采集。
### 返回值 [#返回值-3]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/realtime-media/rtc/reference/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-3]
- [RtcEngine](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_irtcengine)
## muteRecordingSignal [#muterecordingsignal]
设置是否静音录制信号。
```java
public abstract int muteRecordingSignal(boolean muted);
```
如果你已经调用了 [adjustRecordingSignalVolume](/zh-CN/api-reference/rtc/android/audio/audio-capture#api_irtcengine_adjustrecordingsignalvolume) 方法调整录制信号的音量,当你调用该方法并将参数设置为 true 时,SDK 会执行以下操作:
- 记录当前已调整的音量。
- 静音录制信号。
当你再次调用该方法并将参数设置为 false 时,录制信号的音量会恢复为静音前记录的音量。
### 调用时机 [#调用时机-4]
该方法可以在加入频道前或后调用。
### 参数 [#参数-4]
#### `muted` [#muted]
是否静音录制信号:
- true:静音录制信号。
- false:(默认)不静音录制信号。
### 返回值 [#返回值-4]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/realtime-media/rtc/reference/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-4]
- [RtcEngine](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_irtcengine)
## setInEarMonitoringVolume [#setinearmonitoringvolume]
设置耳返音量。
```java
public abstract int setInEarMonitoringVolume(int volume);
```
### 调用时机 [#调用时机-5]
该方法可以在加入频道前或加入频道后调用。
### 参数 [#参数-5]
#### `volume` [#volume-1]
用户的音量,取值范围为 [0, 400]。0 表示静音,100(默认)表示原始音量,400 表示原始音量的四倍(将音频信号放大四倍)。
### 返回值 [#返回值-5]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/realtime-media/rtc/reference/error-code)了解详情和解决建议。
- -2:参数设置不合法,例如耳返音量超出有效范围(小于 0 或大于 400)。
### 所属接口类 [#所属接口类-5]
- [RtcEngine](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_irtcengine)