# 音频采集 (/zh-CN/api-reference/rtc/cpp-all-platforms/audio/audio-capture)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
## adjustLoopbackSignalVolume [#adjustloopbacksignalvolume]
调整声卡采集信号的音量。
```cpp
virtual int adjustLoopbackSignalVolume(int volume) = 0;
```
在调用 [enableLoopbackRecording](/zh-CN/api-reference/rtc/cpp-all-platforms/audio/audio-capture#api_irtcengine_enableloopbackrecording) 启用环路音频采集后,可以调用该方法调整声卡采集信号的音量。
### 参数 [#参数]
混音音量。取值范围为 0 到 100。(默认值为 100,表示原始音量。)
### 返回值 [#返回值]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类]
- [IRtcEngine](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_irtcengine)
## adjustRecordingSignalVolume [#adjustrecordingsignalvolume]
调节采集音频信号的音量。
```cpp
virtual int adjustRecordingSignalVolume(int volume) = 0;
```
如果你只需要静音音频信号,声网建议使用 [muteRecordingSignal](/zh-CN/api-reference/rtc/cpp-all-platforms/audio/audio-capture#api_irtcengine_muterecordingsignal) 方法。
### 调用时机 [#调用时机]
该方法可以在加入频道前或加入频道后调用。
### 参数 [#参数-1]
用户的音量,取值范围为 [0,400]。
- 0:静音。
- 100:(默认)原始音量。
- 400:原始音量的四倍(将音频信号放大四倍)。
### 返回值 [#返回值-1]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-1]
- [IRtcEngine](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_irtcengine)
## enableInEarMonitoring [#enableinearmonitoring]
启用或关闭耳返功能。
```cpp
virtual int enableInEarMonitoring(bool enabled, int includeAudioFilters) = 0;
```
:::note
注: 你必须使用有线或蓝牙耳机才能听到耳返效果。
:::
### 调用时机 [#调用时机-1]
你可以在加入频道前或加入频道后调用该方法。
### 参数 [#参数-2]
是否启用耳返功能。
:::note
注:
- true:启用耳返功能。
- false:(默认)关闭耳返功能。
:::
耳返功能使用的音频滤镜类型,详见 [EAR_MONITORING_FILTER_TYPE](/zh-CN/api-reference/rtc/cpp-all-platforms/enum-earmonitoringfiltertype)。
### 返回值 [#返回值-2]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
- -8:请确保当前的音频路由为蓝牙或有线耳机。
### 所属接口类 [#所属接口类-2]
- [IRtcEngine](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_irtcengine)
## enableLocalAudio [#enablelocalaudio]
启用或关闭本地音频采集功能。
```cpp
virtual int enableLocalAudio(bool enabled) = 0;
```
该方法用于关闭或重新启用本地音频功能,从而停止或重新开始本地音频采集。
该方法与 [muteLocalAudioStream](/zh-CN/api-reference/rtc/cpp-all-platforms/publishnsubscribe#api_irtcengine_mutelocalaudiostream) 的区别如下:
- [enableLocalAudio](/zh-CN/api-reference/rtc/cpp-all-platforms/audio/audio-capture#api_irtcengine_enablelocalaudio):关闭或重新启用本地音频采集和处理。如果通过该方法关闭或重新启用本地音频采集,本地用户可能会听到远端音频播放的中断。
- [muteLocalAudioStream](/zh-CN/api-reference/rtc/cpp-all-platforms/publishnsubscribe#api_irtcengine_mutelocalaudiostream):仅停止或恢复发送本地音频流,不影响音频采集状态。
该方法不影响接收远端音频流。将 `enabled` 设置为 false 适用于只接收远端音频流而不发送本地音频的场景。你可以在加入频道前或加入频道后调用该方法。在加入频道前调用该方法仅设置设备状态,并在加入频道后立即生效。
### 适用场景 [#适用场景]
`enableLocalAudio(false)` 适用于只接收远端音频流而不发送本地采集音频的场景。该方法不会影响接收远端音频流。
### 调用时机 [#调用时机-2]
你可以在加入频道前或加入频道后调用该方法。在加入频道前调用该方法仅设置设备状态,并在加入频道后立即生效。
### 相关回调 [#相关回调]
成功调用该方法后,SDK 会触发 [onLocalAudioStateChanged](/zh-CN/api-reference/rtc/cpp-all-platforms/audio/audio-basic#callback_irtcengineeventhandler_onlocalaudiostatechanged) 回调,报告 `LOCAL_AUDIO_STREAM_STATE_STOPPED`(0)或 `LOCAL_AUDIO_STREAM_STATE_RECORDING`(1)。
### 参数 [#参数-3]
是否启用本地音频采集:
- true:(默认)重新启用本地音频功能,即启动本地音频采集设备(例如麦克风)。
- false:关闭本地音频功能,即停止本地音频采集。
### 返回值 [#返回值-3]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-3]
- [IRtcEngine](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_irtcengine)
## enableLoopbackRecording [#enableloopbackrecording]
启用声卡采集功能。
```cpp
virtual int enableLoopbackRecording(bool enabled, const char* deviceName = NULL) = 0;
```
启用该功能后,声卡的输出音频会被混入发送到远端的音频流中。
:::note
注:
- 该方法仅适用于 macOS 和 Windows 平台。
- 你可以在加入频道前或加入频道后调用该方法。
- 如果你调用了 [disableAudio](/zh-CN/api-reference/rtc/cpp-all-platforms/audio/audio-basic#api_irtcengine_disableaudio) 方法禁用了音频模块,音频采集也会被禁用。若需启用音频采集,请先调用 [enableAudio](/zh-CN/api-reference/rtc/cpp-all-platforms/audio/audio-basic#api_irtcengine_enableaudio) 方法启用音频模块,再调用 [enableLoopbackRecording](/zh-CN/api-reference/rtc/cpp-all-platforms/audio/audio-capture#api_irtcengine_enableloopbackrecording) 方法。
:::
### 参数 [#参数-4]
是否启用声卡采集:
- true:启用声卡采集。你可以在系统的音频设备 > 输出中查看虚拟声卡名称。
- false:禁用声卡采集。系统的音频设备 > 输出中不会显示虚拟声卡名称。
- macOS:虚拟声卡的设备名称。默认值为 NULL,表示使用 `AgoraALD` 进行声卡采集。
- Windows:声卡的设备名称。默认值为 NULL,表示 SDK 使用你设备的声卡进行声卡采集。
### 返回值 [#返回值-4]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-4]
- [IRtcEngine](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_irtcengine)
## enableLoopbackRecordingEx [#enableloopbackrecordingex]
启用声卡采集功能,将声卡输出混入发送的音频流中。
```cpp
virtual int enableLoopbackRecordingEx(const RtcConnection& connection, bool enabled, const char* deviceName = NULL) = 0;
```
启用该功能后,声卡的输出会被混入发送到远端的音频流中。
:::note
注:
- 该方法仅适用于 macOS 和 Windows 平台。
- macOS 不支持默认声卡的声卡采集功能。如需使用该功能,请使用虚拟声卡,并将其名称传入 `deviceName` 参数。推荐使用 `AgoraALD` 作为虚拟声卡。
- 该方法仅支持使用一个声卡进行音频采集。
:::
### 适用场景 [#适用场景-1]
该方法适用于多频道场景。
### 参数 [#参数-5]
连接信息,详见 [RtcConnection](/zh-CN/api-reference/rtc/cpp-all-platforms/class-rtcconnection)。
是否启用声卡采集功能:
- true:启用声卡采集。
- false:(默认)禁用声卡采集。
- macOS:虚拟声卡的设备名称。默认值为 NULL,表示使用 `AgoraALD` 进行声卡采集。
- Windows:声卡的设备名称。默认值为 NULL,表示使用当前设备的声卡进行采集。
### 返回值 [#返回值-5]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-5]
- [IRtcEngineEx](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_irtcengineex)
## muteRecordingSignal [#muterecordingsignal]
设置是否静音录制信号。
```cpp
virtual int muteRecordingSignal(bool mute) = 0;
```
如果你已经调用 [adjustRecordingSignalVolume](/zh-CN/api-reference/rtc/cpp-all-platforms/audio/audio-capture#api_irtcengine_adjustrecordingsignalvolume) 方法调整了录制信号的音量,当你调用该方法并将参数设置为 true 时,SDK 会执行以下操作:
- 记录当前调整后的音量。
- 静音录制信号。
当你再次调用该方法并将参数设置为 false 时,录制信号音量会恢复为静音前记录的音量。该方法可以在加入频道前或后调用。
### 调用时机 [#调用时机-3]
该方法可以在加入频道前或后调用。
### 参数 [#参数-6]
是否静音录制信号:
- true:静音录制信号。
- false:(默认)不静音录制信号。
### 返回值 [#返回值-6]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-6]
- [IRtcEngine](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_irtcengine)
## setInEarMonitoringVolume [#setinearmonitoringvolume]
设置耳返音量。
```cpp
virtual int setInEarMonitoringVolume(int volume) = 0;
```
### 调用时机 [#调用时机-4]
该方法可以在加入频道前或加入频道后调用。
### 参数 [#参数-7]
用户的音量,取值范围为 [0, 400]。
- 0:静音。
- 100:(默认)原始音量。
- 400:原始音量的四倍(将音频信号放大四倍)。
### 返回值 [#返回值-7]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
- -2:参数设置不合法,例如耳返音量超出有效范围(小于 0 或大于 400)。
### 所属接口类 [#所属接口类-7]
- [IRtcEngine](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_irtcengine)