音频设备管理
介绍跟音频设备管理相关的方法和回调。
getAudioDeviceInfo
获取音频设备信息。
abstract getAudioDeviceInfo(): DeviceInfo;
详情
调用该方法后,你可以获取音频设备是否支持极低延时采集和播放。
注意:
- 该方法在加入频道前后均可调用。
返回值
包含音频设备信息的 DeviceInfo 对象。
- 非空:方法调用成功。
- 空:方法调用失败。
getAudioDeviceManager
isSpeakerphoneEnabled
检查扬声器状态启用状态。
abstract isSpeakerphoneEnabled(): boolean;
返回值
true
: 扬声器已开启,语音会输出到扬声器。false
: 扬声器未开启,语音会输出到非扬声器(听筒,耳机等)。
setEnableSpeakerphone
开启或关闭扬声器播放。
abstract setEnableSpeakerphone(speakerOn: boolean): number;
详情
如果 SDK 默认的音频路由(见音频路由)或 setDefaultAudioRouteToSpeakerphone 的设置无法满足你的需求,你可以调用 setEnableSpeakerphone 切换当前的音频路由。成功改变音频路由后,SDK 会触发 onAudioRoutingChanged 回调。
该方法只设置用户在当前频道内使用的音频路由,不会影响 SDK 默认的音频路由。如果用户离开当前频道并加入新的频道,则用户还是会使用 SDK 默认的音频路由。
注意:
- 该方法需要在加入频道后调用。
- 如果用户使用了蓝牙耳机、有线耳机等外接音频播放设备,则该方法的设置无效,音频只会通过外接设备播放。当有多个外接设备时,音频会通过最后一个接入的设备播放。
参数
- speakerOn
-
设置是否开启扬声器播放:
true
: 开启。音频路由为扬声器。false
: 关闭。音频路由为听筒。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。
onAudioDeviceVolumeChanged
音频设备或 app 的音量发生改变回调。
onAudioDeviceVolumeChanged?( deviceType: MediaDeviceType, volume: number, muted: boolean ): void;
当音频播放、采集设备或 app 的音量发生改变时,会触发该回调。
参数
- deviceType
- 设备类型定义。详见 MediaDeviceType。
- volume
- 音量。范围为 [0,255]。
- muted
-
音频设备是否为静音状态:
true
: 音频设备已静音。false
: 音频设备未被静音。