文档首页 > > SDK参考> Windows SDK> 接口参考> 音频设备管理

音频设备管理

分享
更新时间:2020/11/02 GMT+08:00

本章节介绍了Windows SDK的IHRTCAudioDeviceManager接口详情。

表1 IHRTCAudioDeviceManager接口

接口

描述

IHRTCAudioDeviceManager

析构函数

getPlaybackDevices

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

getRecordingDevices

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

setPlaybackDevice

指定音频播放设备

setRecordingDevice

指定音频录制设备

setPlaybackDeviceVolume

设置音频播放设备音量

setRecordingDeviceVolume

设置音频录制设备音量

getPlaybackDeviceVolume

获取音频播放设备音量

getRecordingDeviceVolume

获取音频录制设备音量

setPlaybackDeviceMute

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

setRecordingDeviceMute

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

getPlaybackDeviceMute

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

getRecordingDeviceMute

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

getCurrentPlaybackDevice

获取当前音频播放设备

getCurrentRecordingDevice

获取当前音频录制设备

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
分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!非常感谢您的反馈,我们会继续努力做到更好!
反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问