# 音频采集 (/zh-CN/api-reference/rtc/harmonyos/audio/audio-capture)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
## adjustRecordingSignalVolume [#adjustrecordingsignalvolume]
调节音频采集信号音量。
```ts
public abstract adjustRecordingSignalVolume(volume: number): number;
```
### 调用时机 [#调用时机]
加入频道前后均可调用。
### 调用限制 [#调用限制]
无。
### 参数 [#参数]
音量,取值范围为 [0,400]。
- 0: 静音。
- 100: (默认)原始音量。
- 400: 原始音量的 4 倍,自带溢出保护。
### 返回值 [#返回值]
- 0: 方法调用成功。
- < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类]
- [RtcEngine](/zh-CN/api-reference/rtc/harmonyos/rtc-interface-class#class_irtcengine)
## /zh-CN/api-reference/rtc/harmonyos/audio/audio-capture#api_irtcengine_enableinearmonitoring [#zh-cnapi-referencertcharmonyosaudioaudio-captureapi_irtcengine_enableinearmonitoring]
开启耳返功能。
该方法用于打开或关闭耳返功能。
### 调用时机 [#调用时机-1]
加入频道前后均可调用。
### 调用限制 [#调用限制-1]
用户必须使用耳机(有线和蓝牙均可)才能听到耳返效果。
### 参数 [#参数-1]
开启/关闭耳返功能:
- `true`: 开启耳返功能。
- `false`: (默认)关闭耳返功能。
### 返回值 [#返回值-1]
- 0: 方法调用成功。
- < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
- - 8: 请确保当前的音频路由为蓝牙或耳机。
## enableInEarMonitoring [#enableinearmonitoring]
开启耳返功能。
```ts
public abstract enableInEarMonitoring(enabled: boolean, includeAudioFilters?: Constants.EarMontoringFilterType): number;
```
该方法用于打开或关闭耳返功能。
### 调用时机 [#调用时机-2]
加入频道前后均可调用。
### 调用限制 [#调用限制-2]
用户必须使用耳机(有线和蓝牙均可)才能听到耳返效果。
### 参数 [#参数-2]
开启/关闭耳返功能:
- `true`: 开启耳返功能。
- `false`: (默认)关闭耳返功能。
耳返 Audio filter 类型。详见 [EarMontoringFilterType](/zh-CN/api-reference/rtc/harmonyos/enum-earmonitoringfiltertype)。
### 返回值 [#返回值-2]
- 0: 方法调用成功。
- < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
- - 8: 请确保当前的音频路由为蓝牙或耳机。
### 所属接口类 [#所属接口类-1]
- [RtcEngine](/zh-CN/api-reference/rtc/harmonyos/rtc-interface-class#class_irtcengine)
## enableLocalAudio [#enablelocalaudio]
开启或关闭本地音频采集。
```ts
public abstract enableLocalAudio(enabled: boolean): number;
```
当用户加入频道时,音频功能默认是开启的。该方法可以关闭或重新开启本地音频功能,即停止或重新开始本地音频采集。
该方法与 [muteLocalAudioStream](/zh-CN/api-reference/rtc/harmonyos/publishnsubscribe#api_irtcengine_mutelocalaudiostream) 的区别在于:
- enableLocalAudio: 开启或关闭本地音频采集及处理。使用 enableLocalAudio 关闭或开启本地采集后,本地听远端播放会有短暂中断。
- muteLocalAudioStream: 停止或继续发送本地音频流,不影响音频的采集状态。
### 适用场景 [#适用场景]
该方法不影响接收远端音频流,[enableLocalAudio](/zh-CN/api-reference/rtc/harmonyos/audio/audio-capture#api_irtcengine_enablelocalaudio)`(false)` 适用于只听不发的用户场景。
### 调用时机 [#调用时机-3]
该方法在加入频道前后均可调用。在加入频道前调用只能设置设备状态,在加入频道后才会立即生效。
### 调用限制 [#调用限制-3]
无。
### 相关回调 [#相关回调]
音频功能关闭或重新开启后,会收到 [onLocalAudioStateChanged](/zh-CN/api-reference/rtc/harmonyos/audio/audio-basic#callback_irtcengineeventhandler_onlocalaudiostatechanged) 回调,并报告 STOPPED(0) 或 RECORDING(1)。
### 参数 [#参数-3]
- `true`: 重新开启本地音频功能,即开启本地音频采集(默认);
- `false`: 关闭本地音频功能,即停止本地音频采集。
### 返回值 [#返回值-3]
- 0: 方法调用成功。
- < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-2]
- [RtcEngine](/zh-CN/api-reference/rtc/harmonyos/rtc-interface-class#class_irtcengine)
## muteRecordingSignal [#muterecordingsignal]
是否将录音信号静音。
```ts
public abstract muteRecordingSignal(muted:boolean):number;
```
如果你已经调用 [adjustRecordingSignalVolume](/zh-CN/api-reference/rtc/harmonyos/audio/audio-capture#api_irtcengine_adjustrecordingsignalvolume) 调节了音频采集信号音量,则调用该方法并设置为 `true` 时,SDK 的行为如下:
1. 记录调节后的音量。
2. 将音频采集信号静音。
当你再次调用该方法并设置为 `false` 时,录音信号会恢复为静音前 SDK 记录的音量。
### 调用时机 [#调用时机-4]
加入频道前后均可调用。
### 调用限制 [#调用限制-4]
无。
### 参数 [#参数-4]
- `true`: 静音。
- `false`:(默认)原始音量。
### 返回值 [#返回值-4]
- 0: 方法调用成功。
- < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
## setInEarMonitoringVolume [#setinearmonitoringvolume]
设置耳返音量。
```ts
public abstract setInEarMonitoringVolume(volume: number): number;
```
### 调用时机 [#调用时机-5]
加入频道前后均可调用。
### 调用限制 [#调用限制-5]
无。
### 参数 [#参数-5]
音量,取值范围为 [0,400]。
- 0: 静音。
- 100: (默认)原始音量。
- 400: 原始音量的 4 倍,自带溢出保护。
### 返回值 [#返回值-5]
- 0: 方法调用成功。
- < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
- -2: 参数设置无效,例如耳返音量超出取值范围 (< 0 或 > 400)。
### 所属接口类 [#所属接口类-3]
- [RtcEngine](/zh-CN/api-reference/rtc/harmonyos/rtc-interface-class#class_irtcengine)