音频设备管理
本章节介绍了Windows SDK的IHRTCAudioDeviceManager接口详情。
接口 |
描述 |
---|---|
析构函数 |
|
获取系统音频播放设备列表 |
|
获取系统音频录制设备列表 |
|
指定音频播放设备 |
|
指定音频录制设备 |
|
设置音频播放设备音量 |
|
设置音频录制设备音量 |
|
获取音频播放设备音量 |
|
获取音频录制设备音量 |
|
设置音频播放设备是否静音 |
|
设置音频录制设备是否静音 |
|
获取音频播放设备静音状态 |
|
获取音频录制设备静音状态 |
|
获取当前音频播放设备 |
|
获取当前音频录制设备 |
getPlaybackDevices
virtual int getPlaybackDevices(HRTCDeviceInfo *deviceInfo, unsigned int *counts)
【功能说明】
获取系统音频播放设备列表。
【请求参数】
- deviceInfo:输出参数,获取系统设备详情,包括设备标识和设备名称。具体请参见HRTCDeviceInfo。
- counts:输入输出参数,获取deviceInfo对象数量,输入值为deviceInfo的数量,将会返回小于等于counts数量的设备信息。
【返回参数】
- 0:方法调用成功。
- > 0:方法调用失败。具体请参见HRTCErrorCode。
getRecordingDevices
virtual int getRecordingDevices(HRTCDeviceInfo *deviceInfo, unsigned int *counts)
【功能说明】
获取系统音频录制设备列表。
【请求参数】
- deviceInfo:输出参数,获取系统设备详情,包括设备标识和设备名称。具体请参见HRTCDeviceInfo。
- counts:输入输出参数,获取deviceInfo对象数量,输入值为deviceInfo的数量,将会返回小于等于counts数量的设备信息。
【返回参数】
- 0:方法调用成功。
- > 0:方法调用失败。具体请参见HRTCErrorCode。
setPlaybackDevice
virtual int setPlaybackDevice(const char deviceId[HRTC_MAX_DEVICE_ID_LEN + 1])
【功能说明】
指定音频播放设备。
【请求参数】
deviceId:设备标识。可通过getPlaybackDevices获取。
【返回参数】
- 0:方法调用成功。
- > 0:方法调用失败。具体请参见HRTCErrorCode。
【注意事项】
- 通话前没有选择任何设备,通话中使用默认设备。
- 通话前已选择指定设备,通话中直接生效。
- 通话中有多个音频设备,拨出设备会自动切换。
- 通话中无音频设备,新插入设备,需要重新调用该接口指定设备。
setRecordingDevice
virtual int setRecordingDevice(const char deviceId[HRTC_MAX_DEVICE_ID_LEN+ 1])
【功能说明】
指定音频录制设备。
【请求参数】
deviceId:设备标识。可通过getRecordingDevices获取。
【返回参数】
- 0:方法调用成功。
- > 0:方法调用失败。具体请参见HRTCErrorCode。
【注意事项】
- 通话前没有选择任何设备,通话中使用默认设备。
- 通话前已选择指定设备,通话中直接生效。
- 通话中有多个音频设备,拨出设备会自动切换。
- 通话中无音频设备,新插入设备,需要重新调用该接口指定设备。
setPlaybackDeviceVolume
virtual int setPlaybackDeviceVolume(unsigned int volume)
【功能说明】
设置音频播放设备音量。
【请求参数】
volume:播放设备音量。取值范围:[0,100]。
【返回参数】
- 0:方法调用成功。
- > 0:方法调用失败。具体请参见HRTCErrorCode。
setRecordingDeviceVolume
virtual int setRecordingDeviceVolume(unsigned int volume)
【功能说明】
设置音频录制设备音量。
【请求参数】
volume:录音设备音量。取值范围:[0,100]。
【返回参数】
- 0:方法调用成功。
- > 0:方法调用失败。具体请参见HRTCErrorCode。
getPlaybackDeviceVolume
virtual int getPlaybackDeviceVolume(unsigned int *volume)
【功能说明】
获取音频播放设备音量。
【请求参数】
volume:播放设备音量,取值范围:[0,100]。
【返回参数】
- 0:方法调用成功。
- > 0:方法调用失败。具体请参见HRTCErrorCode。
getRecordingDeviceVolume
virtual int getRecordingDeviceVolume(unsigned int *volume)
【功能说明】
获取音频录制设备音量。
【请求参数】
volume:输出参数,录音设备音量。取值范围:[0,100]。
【返回参数】
- 0:方法调用成功。
- > 0:方法调用失败。具体请参见HRTCErrorCode。
setPlaybackDeviceMute
virtual int setPlaybackDeviceMute(bool mute)
【功能说明】
设置音频播放设备是否静音。
【请求参数】
mute:true表示设备设为静音,false表示设备设为不静音。
【返回参数】
- 0:方法调用成功。
- > 0:方法调用失败。具体请参见HRTCErrorCode。
setRecordingDeviceMute
virtual int setRecordingDeviceMute(bool mute)
【功能说明】
设置音频录制设备是否静音。
【请求参数】
mute:true表示设备设为静音,false表示设备设为非静音。
【返回参数】
- 0:方法调用成功。
- > 0:方法调用失败。具体请参见HRTCErrorCode。
getPlaybackDeviceMute
virtual int getPlaybackDeviceMute(bool *mute)
【功能说明】
获取音频播放设备静音状态。
【请求参数】
mute:true表示已静音状态,false表示非静音状态。
【返回参数】
- 0:方法调用成功。
- > 0:方法调用失败。具体请参见HRTCErrorCode。
getRecordingDeviceMute
virtual int getRecordingDeviceMute(bool *mute)
【功能说明】
获取音频录制设备静音状态。
【请求参数】
mute:true表示已静音状态,false表示非静音状态。
【返回参数】
- 0:方法调用成功。
- > 0:方法调用失败。具体请参见HRTCErrorCode。
getCurrentPlaybackDevice
virtual int getCurrentPlaybackDevice(char deviceId[HRTC_MAX_DEVICE_ID_LEN + 1])
【功能说明】
获取当前音频播放设备。
【请求参数】
deviceId:输出参数,当前播放设备标识。
【返回参数】
- 0:方法调用成功。
- > 0:方法调用失败。具体请参见HRTCErrorCode。
getCurrentRecordingDevice
virtual int getCurrentRecordingDevice(char deviceId[HRTC_MAX_DEVICE_ID_LEN+ 1])
【功能说明】
获取当前音频录制设备。
【请求参数】
deviceId:输出参数,当前录制设备标识。
【返回参数】
- 0:方法调用成功。
- > 0:方法调用失败。具体请参见HRTCErrorCode。
