DingRtcEngineAudioDeviceManager

接口说明

目录

音频设备相关接口

接口详情

• GetRecordingDeviceList：获取系统中的录音设备列表。

  RtcEngineDeviceInfoList * GetRecordingDeviceList ()=0

  返回说明

  系统中的录音设备列表。

  重要

  如果没有安装驱动，那么返回列表为NULL。App需要判断返回值是否为NULL。

• GetCurrentRecordingDeviceId：获取使用的录音设备id。

  String GetCurrentRecordingDeviceId ()=0

  返回说明

  当前音频采集设备id。

• SetCurrentRecordingDeviceId：选择录音设备id。

  int SetCurrentRecordingDeviceId (const char *deviceId)=0

  参数	类型	描述
  deviceId	const char *	音频采集设备id。

  返回说明

  0：成功；非0：失败。

• GetPlayoutDeviceList：获取系统中的扬声器列表。

  RtcEngineDeviceInfoList * GetPlayoutDeviceList ()=0

  返回说明

  音频播放设备列表。

  重要

  如果没有安装驱动，那么返回列表为NULL。App需要判断返回值是否为NULL。

• 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	RtcEngineDeviceType	音频设备类型。
  enable	bool	true表示开启音量观测。 false表示关闭音量观测。

  返回说明

  0：成功；非0：失败。

  重要

  开启音量观测，会分别通过OnRecordingDeviceAudioLevel和OnPlayoutDeviceAudioLevel回调采集和播放设备音量值。