音频采集
- Android
更新时间不可用
adjustRecordingSignalVolume
调节采集音频信号的音量。
public abstract int adjustRecordingSignalVolume(int volume);如果你只需要静音音频信号,声网建议使用 muteRecordingSignal 方法。
调用时机
该方法可以在加入频道前或加入频道后调用。
参数
返回值
- 0:方法调用成功。
- < 0:方法调用失败。详见错误码了解详情和解决建议。
所属接口类
enableInEarMonitoring [1/2]
启用或关闭耳返监听。
public abstract int enableInEarMonitoring(boolean enabled);注: 你必须使用有线或蓝牙耳机才能听到耳返监听效果。
调用时机
该方法可以在加入频道前或加入频道后调用。
参数
返回值
-
0:方法调用成功。
-
< 0:方法调用失败。详见错误码了解详情和解决建议。
- -8:请确保当前音频路由为蓝牙或有线耳机。
所属接口类
enableInEarMonitoring [2/2]
启用或关闭耳返监听功能。
public abstract int enableInEarMonitoring(boolean enabled, int includeAudioFilters);注: 你必须使用有线或蓝牙耳机才能听到耳返监听效果。
调用时机
该方法可以在加入频道前或加入频道后调用。
参数
返回值
-
0:方法调用成功。
-
< 0:方法调用失败。详见错误码了解详情和解决建议。
- -8:请确保当前音频路由为蓝牙或有线耳机。
所属接口类
enableLocalAudio
启用或关闭本地音频采集功能。
public abstract int enableLocalAudio(boolean enabled);enableLocalAudio 用于控制本地音频采集和处理的启用状态。调用该方法关闭或重新启用本地音频采集时,本地用户可能会听到远端音频播放中断。 该方法与 muteLocalAudioStream 的区别如下:
- enableLocalAudio:控制本地音频采集和处理的启用状态。
- muteLocalAudioStream:仅控制是否发送本地音频流,不影响音频采集状态。
适用场景
enableLocalAudio(false) 适用于只接收远端音频流而不发送本地采集音频的场景。该方法不会影响接收远端音频流。
调用时机
你可以在加入频道前或加入频道后调用该方法。在加入频道前调用该方法仅设置设备状态,并在加入频道后立即生效。
相关回调
一旦本地音频功能被关闭或重新启用,SDK 会触发 onLocalAudioStateChanged 回调,报告 LOCAL_AUDIO_STREAM_STATE_STOPPED(0)或 LOCAL_AUDIO_STREAM_STATE_RECORDING(1)。
参数
返回值
- 0:方法调用成功。
- < 0:方法调用失败。详见错误码了解详情和解决建议。
所属接口类
muteRecordingSignal
设置是否静音录制信号。
public abstract int muteRecordingSignal(boolean muted);如果你已经调用了 adjustRecordingSignalVolume 方法调整录制信号的音量,当你调用该方法并将参数设置为 true 时,SDK 会执行以下操作:
- 记录当前已调整的音量。
- 静音录制信号。
当你再次调用该方法并将参数设置为 false 时,录制信号的音量会恢复为静音前记录的音量。
调用时机
该方法可以在加入频道前或后调用。
参数
返回值
- 0:方法调用成功。
- < 0:方法调用失败。详见错误码了解详情和解决建议。
所属接口类
setInEarMonitoringVolume
设置耳返音量。
public abstract int setInEarMonitoringVolume(int volume);调用时机
该方法可以在加入频道前或加入频道后调用。
参数
返回值
-
0:方法调用成功。
-
< 0:方法调用失败。详见错误码了解详情和解决建议。
- -2:参数设置不合法,例如耳返音量超出有效范围(小于 0 或大于 400)。