通过阅读本文,您可以了解到Windows SDK的DingRtcEngineAudioDeviceManager接口详情。
接口说明
目录
音频设备相关接口
API |
描述 |
支持的最低版本 |
获取系统中的录音设备列表。 |
3.0 |
|
获取使用的录音设备id。 |
3.0 |
|
选择录音设备id。 |
3.0 |
|
获取系统中的扬声器列表。 |
3.0 |
|
获取当前使用的扬声器id。 |
3.0 |
|
选择扬声器id。 |
3.0 |
|
获取音频采集设备音量。 |
3.0 |
|
设置音频播放设备音量,音量范围[0,100]。 |
3.0 |
|
静音音频采集设备。 |
3.0 |
|
使用静音帧替换采集到的数据。 |
3.0 |
|
获取音频采集设备静音状态。 |
3.0 |
|
静音音频播放设备。 |
3.0 |
|
获取音频播放设备静音状态。 |
3.0 |
|
开启音频采集设备测试。 |
3.0 |
|
停止音频采集设备测试。 |
3.0 |
|
开启音频播放设备测试。 |
3.0 |
|
停止测试音频播放设备。 |
3.0 |
|
开启/关闭音频设备音量观测。 |
3.0 |
接口详情
-
GetRecordingDeviceList:获取系统中的录音设备列表。
RtcEngineDeviceInfoList * GetRecordingDeviceList ()=0
返回说明
系统中的录音设备列表。
重要返回值需要判断是否为空。如果不为空,用完后调用Release()释放。
-
GetCurrentRecordingDeviceId:获取使用的录音设备id。
String GetCurrentRecordingDeviceId ()=0
返回说明
当前音频采集设备id。
-
SetCurrentRecordingDeviceId:选择录音设备id。
int SetCurrentRecordingDeviceId (const char *deviceId)=0
参数
类型
描述
deviceId
const char *
音频采集设备id。
返回说明
0:成功;非0:失败。
-
GetPlayoutDeviceList:获取系统中的扬声器列表。
RtcEngineDeviceInfoList * GetPlayoutDeviceList ()=0
返回说明
音频播放设备列表。
重要返回值需要判断是否为空。如果不为空,用完后调用Release()释放。
-
GetCurrentPlayoutDeviceId:获取当前使用的扬声器id。
String GetCurrentPlayoutDeviceId ()=0
返回说明
当前音频播放设备id。
-
SetCurrentPlayoutDeviceId:选择扬声器id。
int SetCurrentPlayoutDeviceId (const char *deviceId)=0
参数
类型
描述
deviceId
const char *
音频播放设备id。
返回说明
0:成功;非0:失败。
-
GetRecordingDeviceVolume:获取音频采集设备音量。
int GetRecordingDeviceVolume ()=0
返回说明
>=0:音量;<0:失败。
-
SetPlayoutDeviceVolume:设置音频播放设备音量,音量范围[0,100]。
int SetPlayoutDeviceVolume (int volume)=0
参数
类型
描述
volume
int
音量值。
返回说明
0:成功;非0:失败。
-
SetRecordingDeviceMute:静音音频采集设备。
int SetRecordingDeviceMute (bool mute)=0
参数
类型
描述
mute
bool
是否静音。
true:设备设置为静音。
false:设备设置为不静音。
返回说明
0:成功;非0:失败。
-
SetRecordingDataMute:使用静音帧替换采集到的数据。
int SetRecordingDataMute (bool mute)=0
参数
类型
描述
mute
bool
是否用静音帧代替采集到的音频数据。
true:使用静音帧。
false:不使用静音帧。
返回说明
0:成功;非0:失败。
-
GetRecordingDeviceMute:获取音频采集设备静音状态。
bool GetRecordingDeviceMute ()=0
返回说明
true:已静音状态;false:非静音状态。
-
SetPlayoutDeviceMute:静音音频播放设备。
int SetPlayoutDeviceMute (bool mute)=0
参数
类型
描述
mute
bool
是否静音。
true:设备设置为静音。
false:设备设置为不静音。
返回说明
0:成功;非0:失败。
-
GetPlayoutDeviceMute:获取音频播放设备静音状态。
bool GetPlayoutDeviceMute ()=0
返回说明
true:已静音状态;false:非静音状态。
-
StartRecordingDeviceTest:开启音频采集设备测试。
int StartRecordingDeviceTest ()=0
返回说明
0:成功;非0:失败。
重要开始测试后音量信息通过OnRecordingDeviceAudioLevel回调返回。
-
StopRecordingDeviceTest:停止音频采集设备测试。
int StopRecordingDeviceTest ()=0
返回说明
0:成功;非0:失败。
-
StartPlayoutDeviceTest:开启音频播放设备测试。
int StartPlayoutDeviceTest (const char *waveFilePath)=0
参数
类型
描述
waveFilePath
const char *
wave文件路径。
返回说明
0:成功;非0:失败。
重要开始测试后音量信息通过OnPlayoutDeviceAudioLevel回调返回。
-
StopPlayoutDeviceTest:停止测试音频播放设备。
int StopPlayoutDeviceTest ()=0
返回说明
0:成功;非0:失败。
-
EnableAudioLevelObserver:开启/关闭音频设备音量观测。
int EnableAudioLevelObserver (RtcEngineDeviceType deviceType, bool enable)=0
参数
类型
描述
deviceType
音频设备类型。
enable
bool
true表示开启音量观测。
false表示关闭音量观测。
返回说明
0:成功;非0:失败。
重要开启音量观测,会分别通过OnRecordingDeviceAudioLevel和OnPlayoutDeviceAudioLevel回调采集和播放设备音量值。