音频设备管理

IHRTCAudioDeviceManager

virtual ~IHRTCAudioDeviceManager()

【功能说明】

析构函数。

getPlaybackDevices

int getPlaybackDevices(HRTCDeviceInfo *deviceInfo, unsigned int *counts)

【功能说明】

获取系统音频播放设备列表。

【请求参数】

• deviceInfo：输出参数，获取系统设备详情，包括设备标识和设备名称。具体请参见HRTCDeviceInfo。
• counts：输入输出参数，获取deviceInfo对象数量，输入值为deviceInfo的数量，将会返回小于等于counts数量的设备信息。

【返回参数】

• 0：方法调用成功。
• > 0：方法调用失败。具体请参见HRTCErrorCode

getRecordingDevices

int getRecordingDevices(HRTCDeviceInfo *deviceInfo, unsigned int *counts)

【功能说明】

获取系统音频录制设备列表。

【请求参数】

• deviceInfo：输出参数，获取系统设备详情，包括设备标识和设备名称。具体请参见HRTCDeviceInfo。
• counts：输入输出参数，获取deviceInfo对象数量，输入值为deviceInfo的数量，将会返回小于等于counts数量的设备信息。

【返回参数】

• 0：方法调用成功。
• > 0：方法调用失败。具体请参见HRTCErrorCode。

setPlaybackDevice

int setPlaybackDevice(const char deviceId[HRTC_MAX_DEVICE_ID_LEN + 1])

【功能说明】

指定音频播放设备。

【请求参数】

deviceId：设备标识。可通过getPlaybackDevices获取。

【返回参数】

• 0：方法调用成功。
• > 0：方法调用失败。具体请参见HRTCErrorCode。

【注意事项】

• 通话前没有选择任何设备，通话中使用默认设备；
• 通话前已选择指定设备，通话中直接生效；
• 通话中有多个音频设备，拨出设备会自动切换；
• 通话中无音频设备，新插入设备，需要重新调用该接口指定设备。

setRecordingDevice

int setRecordingDevice(const char deviceId[HRTC_MAX_DEVICE_ID_LEN+ 1])

【功能说明】

指定音频录制设备。

【请求参数】

deviceId：设备标识。可通过getRecordingDevices获取。

【返回参数】

• 0：方法调用成功。
• > 0：方法调用失败。具体请参见HRTCErrorCode。

【注意事项】

• 通话前没有选择任何设备，通话中使用默认设备；
• 通话前已选择指定设备，通话中直接生效；
• 通话中有多个音频设备，拨出设备会自动切换；
• 通话中无音频设备，新插入设备，需要重新调用该接口指定设备。

setPlaybackDeviceVolume

int setPlaybackDeviceVolume(unsigned int volume)

【功能说明】

设置音频播放设备音量。

【请求参数】

volume：播放设备音量。取值范围：[0,100]。

【返回参数】

• 0：方法调用成功。
• > 0：方法调用失败。具体请参见HRTCErrorCode。

setRecordingDeviceVolume

int setRecordingDeviceVolume(unsigned int volume)

【功能说明】

设置音频录制设备音量。

【请求参数】

volume：录音设备音量。取值范围：[0,100]。

【返回参数】

• 0：方法调用成功。
• > 0：方法调用失败。具体请参见HRTCErrorCode。

getPlaybackDeviceVolume

int getPlaybackDeviceVolume(unsigned int *volume)

【功能说明】

获取音频播放设备音量。

【请求参数】

volume：播放设备音量，取值范围：[0,100]。

【返回参数】

• 0：方法调用成功。
• > 0：方法调用失败。具体请参见HRTCErrorCode。

getRecordingDeviceVolume

int getRecordingDeviceVolume(unsigned int *volume)

【功能说明】

获取音频录制设备音量。

【请求参数】

volume：输出参数，录音设备音量。取值范围：[0,100]。

【返回参数】

• 0：方法调用成功。
• > 0：方法调用失败。具体请参见HRTCErrorCode。

setPlaybackDeviceMute

int setPlaybackDeviceMute(bool mute)

【功能说明】

设置音频播放设备是否静音。

【请求参数】

mute：true表示设备设为静音。false表示设备设为不静音。

【返回参数】

• 0：方法调用成功。
• > 0：方法调用失败。具体请参见HRTCErrorCode。

setRecordingDeviceMute

int setRecordingDeviceMute(bool mute)

【功能说明】

设置音频录制设备是否静音。

【请求参数】

mute：true表示设备设为静音。false表示设备设为非静音。

【返回参数】

• 0：方法调用成功。
• > 0：方法调用失败。具体请参见HRTCErrorCode。

getPlaybackDeviceMute

int getPlaybackDeviceMute(bool *mute)

【功能说明】

获取音频播放设备静音状态。

【请求参数】

mute：true表示已静音状态。false表示非静音状态。

【返回参数】

• 0：方法调用成功。
• > 0：方法调用失败。具体请参见HRTCErrorCode。

getRecordingDeviceMute

int getRecordingDeviceMute(bool *mute)

【功能说明】

获取音频录制设备静音状态。

【请求参数】

mute：true表示已静音状态。false表示非静音状态。

【返回参数】

• 0：方法调用成功。
• > 0：方法调用失败。具体请参见HRTCErrorCode。

getCurrentPlaybackDevice

int getCurrentPlaybackDevice(char deviceId[HRTC_MAX_DEVICE_ID_LEN + 1])

【功能说明】

获取当前音频播放设备。

【请求参数】

deviceId：输出参数，当前播放设备标识。

【返回参数】

• 0：方法调用成功。
• > 0：方法调用失败。具体请参见HRTCErrorCode。

getCurrentRecordingDevice

int getCurrentRecordingDevice(char deviceId[HRTC_MAX_DEVICE_ID_LEN+ 1])

【功能说明】

获取当前音频录制设备。

【请求参数】

deviceId：输出参数，当前录制设备标识

【返回参数】

• 0：方法调用成功。
• > 0：方法调用失败。具体请参见HRTCErrorCode。