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