音频采集
adjustRecordingSignalVolume:
调节采集音量。
Objective-C
- (int)adjustRecordingSignalVolume:(NSInteger)volume NS_SWIFT_NAME(adjustRecordingSignalVolume(_:));
如果你只需要静音音频信号，声网建议使用 muteRecordingSignal: 方法。
调用时机
该方法可以在加入频道前或后调用。
参数
- volume
- 用户的音量。取值范围为 [0,400]。
- 0：静音。
- 100：（默认）原始音量。
- 400：原始音量的四倍（将音频信号放大四倍）。
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
enableInEarMonitoring:
启用或关闭耳返监听功能。
Objective-C
- (int)enableInEarMonitoring:(BOOL)enabled NS_SWIFT_NAME(enable(inEarMonitoring:));
你可以调用该方法启用或关闭耳返监听功能。
信息
enableInEarMonitoring: 仅在使用有线或蓝牙耳机时有效。
调用时机
该方法可以在加入频道前或加入频道后调用。
参数
- enabled
- 是否启用耳返监听功能：
- YES：启用耳返监听功能。
- NO：（默认）关闭耳返监听功能。
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
- -8：请确保当前音频路由为蓝牙或耳机。
enableInEarMonitoring:includeAudioFilters:
启用或关闭耳返监听功能。
Objective-C
- (int)enableInEarMonitoring:(BOOL)enabled includeAudioFilters:(AgoraEarMonitoringFilterType)includeAudioFilters NS_SWIFT_NAME(enable(inEarMonitoring:includeAudioFilters:));
信息
你必须使用有线或蓝牙耳机才能听到耳返监听效果。
调用时机
该方法可以在加入频道前或加入频道后调用。
参数
- enabled
- 是否启用耳返监听功能。
- YES：启用耳返监听。
- NO：（默认）关闭耳返监听。
- includeAudioFilters
- 耳返监听的音频滤波器类型，详见 AgoraEarMonitoringFilterType。
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
- -8：请确保当前音频路由为蓝牙或有线耳机。
enableLocalAudio:
启用或关闭本地音频采集功能。
Objective-C
- (int)enableLocalAudio:(BOOL)enabled NS_SWIFT_NAME(enableLocalAudio(_:));
enableLocalAudio: 方法用于启用或关闭本地音频采集功能。默认情况下，加入频道时会启用音频功能。调用该方法可以停止或重新启动本地音频采集。 该方法与 muteLocalAudioStream: 的区别如下：
- enableLocalAudio:：关闭或重新启用本地音频采集和处理。如果使用该方法关闭或重新启用本地音频采集，可能会导致远端音频播放出现短暂中断。
- muteLocalAudioStream:：仅停止或恢复发送本地音频流，不影响音频采集状态。
enabled 设为 NO 适用于只接收远端音频而不发送本地音频的场景。你可以在加入频道前或加入频道后调用该方法。在加入频道前调用时，仅设置设备状态，加入频道后立即生效。适用场景
enableLocalAudio(false) 适用于只接收远端音频流而不发送本地采集音频的场景。该方法不会影响接收远端音频流。
调用时机
你可以在加入频道前或加入频道后调用该方法。在加入频道前调用时，仅设置设备状态，加入频道后立即生效。
相关回调
成功调用该方法后，SDK 会触发 rtcEngine:localAudioStateChanged:reason: 回调，报告 AgoraAudioLocalStateStopped（0）或 AgoraAudioLocalStateRecording（1）。
参数
- enabled
- YES：（默认）重新启用本地音频功能，即启动本地音频采集设备（例如麦克风）。
- NO：关闭本地音频功能，即停止本地音频采集。
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。
muteRecordingSignal:
设置是否静音录制信号。
Objective-C
- (int)muteRecordingSignal:(BOOL)muted NS_SWIFT_NAME(muteRecordingSignal(_:));
如果你已经调用了 adjustRecordingSignalVolume: 方法调整了录制信号的音量，当你调用该方法并将参数设置为 YES 时，SDK 的行为如下：
- 记录调整后的音量。
- 静音录制信号。
调用时机
该方法可以在加入频道前或后调用。
参数
- muted
- YES：静音录制信号。
- NO：（默认）不静音录制信号。
返回值
- 0：方法调用成功。
- < 0：方法调用失败。详见错误码了解详情和解决建议。