# 音频采集 (/zh-CN/api-reference/rtc/unreal-cpp/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/unreal-cpp/audio/audio-capture#api_irtcengine_enableloopbackrecording) 开启声卡采集后,你可以调用该方法调节声卡采集的信号音量。 ### 参数 [#参数] 音乐文件音量范围为 0~100。100 (默认值)为原始文件音量。 ### 返回值 [#返回值] - 0: 方法调用成功 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类] - [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine) ## adjustRecordingSignalVolume [#adjustrecordingsignalvolume] 调节音频采集信号音量。 ```cpp virtual int adjustRecordingSignalVolume(int volume) = 0; ``` 如果你只需将音频信号静音,建议你使用 [muteRecordingSignal](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-capture#api_irtcengine_muterecordingsignal)。 ### 调用时机 [#调用时机] 加入频道前后均可调用。 ### 调用限制 [#调用限制] 无。 ### 参数 [#参数-1] 音量,取值范围为 [0,400]。 - 0: 静音。 - 100: (默认)原始音量。 - 400: 原始音量的 4 倍,自带溢出保护。 ### 返回值 [#返回值-1] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-1] - [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine) ## enableInEarMonitoring [#enableinearmonitoring] 开启耳返功能。 ```cpp virtual int enableInEarMonitoring(bool enabled, int includeAudioFilters) = 0; ``` 该方法用于打开或关闭耳返功能。 ### 调用时机 [#调用时机-1] 加入频道前后均可调用。 ### 调用限制 [#调用限制-1] 用户必须使用耳机(有线和蓝牙均可)才能听到耳返效果。 ### 参数 [#参数-2] 开启/关闭耳返功能: - `true`: 开启耳返功能。 - `false`: (默认)关闭耳返功能。 耳返 Audio filter 类型。详见 [EAR_MONITORING_FILTER_TYPE](/zh-CN/api-reference/rtc/unreal-cpp/enum-earmonitoringfiltertype)。 ### 返回值 [#返回值-2] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 - - 8: 请确保当前的音频路由为蓝牙或耳机。 ### 所属接口类 [#所属接口类-2] - [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine) ## enableLocalAudio [#enablelocalaudio] 开启或关闭本地音频采集。 ```cpp virtual int enableLocalAudio(bool enabled) = 0; ``` 当用户加入频道时,音频功能默认是开启的。该方法可以关闭或重新开启本地音频功能,即停止或重新开始本地音频采集。 该方法与 [muteLocalAudioStream](/zh-CN/api-reference/rtc/unreal-cpp/publishnsubscribe#api_irtcengine_mutelocalaudiostream) 的区别在于: - enableLocalAudio: 开启或关闭本地音频采集及处理。使用 enableLocalAudio 关闭或开启本地采集后,本地听远端播放会有短暂中断。 - muteLocalAudioStream: 停止或继续发送本地音频流,不影响音频的采集状态。 ### 适用场景 [#适用场景] 该方法不影响远端音频流的接收和播放。enableLocalAudio`(false)` 适用于只接收远端音频而不发送本地采集音频的场景。 ### 调用时机 [#调用时机-2] 该方法在加入频道前后均可调用。在加入频道前调用只能设置设备状态,在加入频道后才会立即生效。 ### 调用限制 [#调用限制-2] 无。 ### 相关回调 [#相关回调] 音频功能关闭或重新开启后,会收到 [onLocalAudioStateChanged](/zh-CN/api-reference/rtc/unreal-cpp/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/unreal-cpp/rtc-interface-class#class_irtcengine) ## enableLoopbackRecording [#enableloopbackrecording] 开启声卡采集。 ```cpp virtual int enableLoopbackRecording(bool enabled, const char* deviceName = NULL) = 0; ``` ### 详情 [#详情-1] 启用声卡采集功能后,声卡播放的声音会被合到本地音频流中,从而可以发送到远端。 :::caution 注意: - 该方法仅适用于 macOS 和 Windows 平台。 - 该方法在加入频道前后都能调用。 - 如果你调用了 [disableAudio](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-basic#api_irtcengine_disableaudio) 关闭音频模块,声卡采集功能也会被关闭。如果你需要再次启用声卡采集功能,需要调用 [enableAudio](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-basic#api_irtcengine_enableaudio) 启用音频模块后再次调用 enableLoopbackRecording。 ::: ### 参数 [#参数-4] 是否开启声卡采集: - `true`: 开启声卡采集;系统**声音 > 输出**界面显示虚拟声卡名称。 - `false`:(默认)关闭声卡采集;系统**声音 > 输出**界面不显示虚拟声卡名称。 - macOS: 虚拟声卡的设备名。默认为空,代表使用 AgoraALD 虚拟声卡进行采集。 - Windows: 声卡的设备名。默认为空,代表使用设备自带的声卡进行采集。 ### 返回值 [#返回值-4] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-4] - [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine) ## enableLoopbackRecordingEx [#enableloopbackrecordingex] 开启声卡采集。 ```cpp virtual int enableLoopbackRecordingEx(const RtcConnection& connection, bool enabled, const char* deviceName = NULL) = 0; ``` ### 详情 [#详情-2] 启用声卡采集功能后,声卡播放的声音会被合到本地音频流中,从而可以发送到远端。 :::caution 注意: - 该方法仅适用于 macOS 和 Windows 平台。 - macOS 系统默认声卡不支持采集功能,如果你需要使用该功能,请启用一个虚拟声卡,并将 deviceName 设为该虚拟声卡的设备名。声网推荐你使用声网自研的虚拟声卡 AgoraALD 进行采集。 - 该方法目前仅支持一路声卡采集。 ::: ### 参数 [#参数-5] Connection 信息。详见 [RtcConnection](/zh-CN/api-reference/rtc/unreal-cpp/class-rtcconnection)。 是否开启声卡采集: - `true`: 开启声卡采集。 - `false`:(默认)不开启声卡采集。 - macOS: 虚拟声卡的设备名。默认为空,代表使用 AgoraALD 虚拟声卡进行采集。 - Windows: 声卡的设备名。默认为空,代表使用设备自带的声卡进行采集。 ### 返回值 [#返回值-5] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-5] - [IRtcEngineEx](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengineex) ## muteRecordingSignal [#muterecordingsignal] 是否将录音信号静音。 ```cpp virtual int muteRecordingSignal(bool mute) = 0; ``` 如果你已经调用 [adjustRecordingSignalVolume](/zh-CN/api-reference/rtc/unreal-cpp/audio/audio-capture#api_irtcengine_adjustrecordingsignalvolume) 调节了音频采集信号音量,则调用该方法并设置为 `true` 时,SDK 的行为如下: 1. 记录调节后的音量。 2. 将音频采集信号静音。 当你再次调用该方法并设置为 `false` 时,录音信号会恢复为静音前 SDK 记录的音量。 ### 调用时机 [#调用时机-3] 加入频道前后均可调用。 ### 调用限制 [#调用限制-3] 无。 ### 参数 [#参数-6] - `true`: 静音。 - `false`:(默认)原始音量。 ### 返回值 [#返回值-6] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-6] - [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine) ## setInEarMonitoringVolume [#setinearmonitoringvolume] 设置耳返音量。 ```cpp virtual int setInEarMonitoringVolume(int volume) = 0; ``` ### 调用时机 [#调用时机-4] 加入频道前后均可调用。 ### 调用限制 [#调用限制-4] 无。 ### 参数 [#参数-7] 音量,取值范围为 [0,400]。 - 0: 静音。 - 100: (默认)原始音量。 - 400: 原始音量的 4 倍,自带溢出保护。 ### 返回值 [#返回值-7] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 - -2: 参数设置无效,例如耳返音量超出取值范围 (< 0 或 > 400)。 ### 所属接口类 [#所属接口类-7] - [IRtcEngine](/zh-CN/api-reference/rtc/unreal-cpp/rtc-interface-class#class_irtcengine)