桌面端音频设备管理

EnumeratePlaybackDevicesCopy Anchor Link

获取系统中所有的播放设备列表。

public abstract DeviceInfo[] EnumeratePlaybackDevices();

详情Copy Anchor Link

返回值Copy Anchor Link

• 方法调用成功，返回一个 DeviceInfo 数组，包含所有音频播放设备的设备 ID 和设备名称。
• 方法调用失败: NULL。

EnumerateRecordingDevicesCopy Anchor Link

获取系统中所有的音频采集设备列表。

abstract DeviceInfo[] EnumerateRecordingDevices();

详情Copy Anchor Link

返回值Copy Anchor Link

• 方法调用成功，返回一个 DeviceInfo 数组，包含所有音频采集设备的设备 ID 和设备名称。
• 方法调用失败: NULL。

FollowSystemLoopbackDeviceCopy Anchor Link

设置声卡采集设备是否跟随系统默认的播放设备。

public abstract int FollowSystemLoopbackDevice(bool enable);

详情Copy Anchor Link

参数Copy Anchor Link

enableCopy Anchor Link

是否跟随系统默认的播放设备：

• true：跟随。当系统默认播放设备发生改变时，SDK 立即跟随切换声卡采集设备。
• false：不跟随。只有当 SDK 使用的声卡采集设备被移除后，SDK 才切换至系统默认的音频播放设备。

返回值Copy Anchor Link

• 0: 方法调用成功。
• < 0: 方法调用失败。 详见 错误码 了解详情和解决建议。

FollowSystemPlaybackDeviceCopy Anchor Link

设置 SDK 使用的音频播放设备跟随系统默认的音频播放设备。

public abstract int FollowSystemPlaybackDevice(bool enable);

详情Copy Anchor Link

参数Copy Anchor Link

enableCopy Anchor Link

是否跟随系统默认的音频播放设备：

• true：跟随。当系统默认音频播放设备发生改变时，SDK 立即切换音频播放设备。
• false：不跟随。只有当 SDK 使用的音频播放设备被移除后，SDK 才切换至系统默认的音频播放设备。

返回值Copy Anchor Link

• 0: 方法调用成功。
• < 0: 方法调用失败。 详见 错误码 了解详情和解决建议。

FollowSystemRecordingDeviceCopy Anchor Link

设置 SDK 使用的音频采集设备跟随系统默认的音频采集设备。

public abstract int FollowSystemRecordingDevice(bool enable);

详情Copy Anchor Link

参数Copy Anchor Link

enableCopy Anchor Link

是否跟随系统默认的音频采集设备：

• true：跟随。当系统默认的音频采集设备改变时，SDK 立即切换音频采集设备。
• false：不跟随。只有当 SDK 使用的音频采集设备被移除后，SDK 才切换至系统默认的音频采集设备。

返回值Copy Anchor Link

• 0：方法调用成功。
• < 0：方法调用失败。 详见 错误码 了解详情和解决建议。

GetAudioDeviceManagerCopy Anchor Link

获取 IAudioDeviceManager 对象，以管理音频设备。

public abstract IAudioDeviceManager GetAudioDeviceManager();

返回值Copy Anchor Link

一个 IAudioDeviceManager 对象。

GetLoopbackDeviceCopy Anchor Link

获取当前的声卡采集设备。

public abstract int GetLoopbackDevice(ref string deviceId);

详情Copy Anchor Link

参数Copy Anchor Link

deviceIdCopy Anchor Link

输出参数，当前声卡采集设备的 ID。

返回值Copy Anchor Link

• 0: 方法调用成功。
• < 0: 方法调用失败。 详见 错误码 了解详情和解决建议。

GetPlaybackDefaultDevice [1/2]Copy Anchor Link

获取系统默认的音频播放设备。

public abstract int GetPlaybackDefaultDevice(ref string deviceId, ref string deviceName);

详情Copy Anchor Link

参数Copy Anchor Link

deviceIdCopy Anchor Link

输出参数，系统默认的音频播放设备 ID。

deviceNameCopy Anchor Link

输出参数，系统默认的音频播放设备名称。

返回值Copy Anchor Link

• 0：方法调用成功。
• < 0：方法调用失败。 详见 错误码 了解详情和解决建议。

GetPlaybackDeviceCopy Anchor Link

获取当前音频播放设备。

public abstract int GetPlaybackDevice(ref string deviceId);

详情Copy Anchor Link

参数Copy Anchor Link

deviceIdCopy Anchor Link

输出参数，当前音频播放设备的设备 ID。

返回值Copy Anchor Link

• 0: 方法调用成功。
• < 0: 方法调用失败。 详见 错误码 了解详情和解决建议。

GetPlaybackDeviceInfo [1/2]Copy Anchor Link

获取音频播放设备信息。

public abstract int GetPlaybackDeviceInfo(ref string deviceId, ref string deviceName);

详情Copy Anchor Link

参数Copy Anchor Link

deviceIdCopy Anchor Link

输出参数，播放设备的设备 ID。

deviceNameCopy Anchor Link

输出参数，播放设备的设备名称。

返回值Copy Anchor Link

• 0: 方法调用成功。
• < 0: 方法调用失败。 详见 错误码 了解详情和解决建议。

GetPlaybackDeviceMuteCopy Anchor Link

获取当前播放设备静音状态。

public abstract bool GetPlaybackDeviceMute();

返回值Copy Anchor Link

• true: 播放设备为静音状态。
• false: 播放设备为非静音状态。

GetPlaybackDeviceVolumeCopy Anchor Link

获取播放设备音量。

public abstract int GetPlaybackDeviceVolume();

返回值Copy Anchor Link

播放设备音量。取值范围 [0,255]。

GetRecordingDefaultDevice [1/2]Copy Anchor Link

获取系统默认的音频采集设备。

public abstract int GetRecordingDefaultDevice(ref string deviceId, ref string deviceName);

详情Copy Anchor Link

参数Copy Anchor Link

deviceIdCopy Anchor Link

输出参数，系统默认的音频采集设备 ID。

deviceNameCopy Anchor Link

输出参数，系统默认的音频采集设备名称。

返回值Copy Anchor Link

• 0：方法调用成功。
• < 0：方法调用失败。 详见 错误码 了解详情和解决建议。

GetRecordingDeviceCopy Anchor Link

获取当前音频采集设备。

public abstract int GetRecordingDevice(ref string deviceId);

详情Copy Anchor Link

参数Copy Anchor Link

deviceIdCopy Anchor Link

输出参数。当前采集设备的设备 ID。

返回值Copy Anchor Link

• 0: 方法调用成功。
• < 0: 方法调用失败。 详见 错误码 了解详情和解决建议。

GetRecordingDeviceInfo [1/2]Copy Anchor Link

获取音频采集设备信息。

public abstract int GetRecordingDeviceInfo(ref string deviceId, ref string deviceName);

详情Copy Anchor Link

参数Copy Anchor Link

deviceIdCopy Anchor Link

输出参数，播放设备的设备 ID。

deviceNameCopy Anchor Link

输出参数，播放设备的设备名称。

返回值Copy Anchor Link

• 0: 方法调用成功。
• < 0: 方法调用失败。 详见 错误码 了解详情和解决建议。

GetRecordingDeviceMuteCopy Anchor Link

获取当前音频采集设备静音状态。

public abstract bool GetRecordingDeviceMute();

返回值Copy Anchor Link

• true: 采集设备为静音状态。
• false: 采集设备为非静音状态。

GetRecordingDeviceVolumeCopy Anchor Link

获取音频采集设备音量。

public abstract int GetRecordingDeviceVolume();

详情Copy Anchor Link

返回值Copy Anchor Link

音频采集设备音量。取值范围 [0,255]。

SetDeviceCopy Anchor Link

通过设备 ID 指定视频采集设备。

public abstract int SetDevice(string deviceIdUTF8);

详情Copy Anchor Link

参数Copy Anchor Link

deviceIdUTF8Copy Anchor Link

设备 ID。可通过调用 EnumerateVideoDevices 方法获取。

返回值Copy Anchor Link

• 0: 方法调用成功。
• < 0: 方法调用失败。 详见 错误码 了解详情和解决建议。

SetLoopbackDeviceCopy Anchor Link

指定声卡采集设备。

public abstract int SetLoopbackDevice(string deviceId);

详情Copy Anchor Link

SDK 默认采用当前的播放设备作为声卡采集设备，如果想要指定其他音频设备作为声卡采集设备，则调用该方法并设置 deviceId 为你想要指定的声卡采集设备。

该方法可以更改当前的音频采集设备，但不改变系统默认的音频采集设备。假设系统默认的音频采集设备是麦克风 1，你在加入频道前调用该方法设置当前的音频路由为声卡 1，如果在此时进行设备检测，SDK 会对声卡 1 做设备检测。检测结束后，当你加入频道时 SDK 依然会选择使用系统默认的音频采集设备，即麦克风 1。

参数Copy Anchor Link

deviceIdCopy Anchor Link

指定 SDK 的声卡采集设备。由 EnumeratePlaybackDevices 获取。插拔设备不会影响 deviceId。

返回值Copy Anchor Link

• 0: 方法调用成功。
• < 0: 方法调用失败。 详见 错误码 了解详情和解决建议。

SetPlaybackDeviceCopy Anchor Link

指定播放设备。

public abstract int SetPlaybackDevice(string deviceId);

详情Copy Anchor Link

该方法可以更改当前的音频路由，但不会改变系统默认的音频路由。假设系统默认的音频路由是扬声器 1，你在加入频道前调用该方法设置当前的音频路由为扬声器 2，如果在此时进行设备检测，SDK 会对扬声器 2 进行检测。检测结束后，当你加入频道时 SDK 依然会选择使用系统默认的音频路由，即扬声器 1。

参数Copy Anchor Link

deviceIdCopy Anchor Link

指定播放设备。由 EnumeratePlaybackDevices 获取。插拔设备不会影响 deviceId。

返回值Copy Anchor Link

• 0: 方法调用成功。
• < 0: 方法调用失败。 详见 错误码 了解详情和解决建议。

SetPlaybackDeviceMuteCopy Anchor Link

设置播放设备静音。

public abstract int SetPlaybackDeviceMute(bool mute);

参数Copy Anchor Link

muteCopy Anchor Link

是否设置播放设备为静音：

• true: 播放设备设为静音。
• false: 播放设备不设为静音。

返回值Copy Anchor Link

• 0: 方法调用成功。
• < 0: 方法调用失败。 详见 错误码 了解详情和解决建议。

SetPlaybackDeviceVolumeCopy Anchor Link

设置播放设备音量。

public abstract int SetPlaybackDeviceVolume(int volume);

详情Copy Anchor Link

参数Copy Anchor Link

volumeCopy Anchor Link

播放设备音量。取值范围为 [0,255]。

返回值Copy Anchor Link

• 0: 方法调用成功。
• < 0: 方法调用失败。 详见 错误码 了解详情和解决建议。

SetRecordingDeviceCopy Anchor Link

指定音频采集设备。

public abstract int SetRecordingDevice(string deviceId);

详情Copy Anchor Link

该方法可以更改当前的音频采集设备，但不改变系统默认的音频采集设备。假设系统默认的音频采集设备是麦克风 1，你在加入频道前调用该方法设置当前的音频路由为蓝牙耳机 1，如果在此时进行设备检测，SDK 会对蓝牙耳机 1 进行检测。检测结束后，当你加入频道时 SDK 依然会选择使用系统默认的音频采集设备，即麦克风 1。

参数Copy Anchor Link

deviceIdCopy Anchor Link

音频采集设备的 Device ID。可通过 EnumerateRecordingDevices 获取。插拔设备不会影响 deviceId。

返回值Copy Anchor Link

• 0: 方法调用成功。
• < 0: 方法调用失败。 详见 错误码 了解详情和解决建议。

SetRecordingDeviceMuteCopy Anchor Link

设置当前音频采集设备静音。

public abstract int SetRecordingDeviceMute(bool mute);

参数Copy Anchor Link

muteCopy Anchor Link

是否设置音频采集设备静音：

• true: 采集设备静音。
• false: 采集设备为非静音。

返回值Copy Anchor Link

• 0: 方法调用成功。
• < 0: 方法调用失败。 详见 错误码 了解详情和解决建议。

SetRecordingDeviceVolumeCopy Anchor Link

设置音频采集设备音量。

public abstract int SetRecordingDeviceVolume(int volume);

详情Copy Anchor Link

参数Copy Anchor Link

volumeCopy Anchor Link

音频采集设备音量。取值范围 [0,255]。0 代表无声，255 代表最大音量。

返回值Copy Anchor Link

• 0: 方法调用成功。
• < 0: 方法调用失败。 详见 错误码 了解详情和解决建议。

StartAudioDeviceLoopbackTestCopy Anchor Link

开始音频设备回路测试。

public abstract int StartAudioDeviceLoopbackTest(int indicationInterval);

详情Copy Anchor Link

该方法测试音频采集和播放设备是否能正常工作。一旦测试开始，音频采集设备会采集本地音频，然后使用音频播放设备播放出来。SDK 会按设置的时间间隔触发两个 OnAudioVolumeIndication 回调，分别报告音频采集设备（uid = 0）和音频播放设置（uid = 1）的音量信息。

参数Copy Anchor Link

indicationIntervalCopy Anchor Link

SDK 触发 OnAudioVolumeIndication 回调的时间间隔，单位为毫秒。建议设置到大于 200 毫秒。不得少于 10 毫秒，否则会收不到 OnAudioVolumeIndication 回调。

返回值Copy Anchor Link

• 0: 方法调用成功。
• < 0: 方法调用失败。 详见 错误码 了解详情和解决建议。

StartPlaybackDeviceTestCopy Anchor Link

启动音频播放设备测试。

public abstract int StartPlaybackDeviceTest(string testAudioFilePath);

详情Copy Anchor Link

该方法用于测试本地音频播放设备是否能正常工作。启动测试后，SDK 播放指定的音频文件，测试者如果能听到声音，说明播放设备能正常工作。

调用该方法后，SDK 会每隔 100 毫秒触发一次 OnAudioVolumeIndication 回调，报告 uid = 1 及播放设备的音量信息。

该方法和 StartEchoTest 的区别在于该方法检测本地的音频播放设备能否正常工作，后者可以检测音视频设备及网络是否正常。

参数Copy Anchor Link

testAudioFilePathCopy Anchor Link

音频文件的绝对路径，路径字符串使用 UTF-8 编码格式。

• 支持文件格式: wav、mp3、m4a、aac。
• 支持文件采样率: 8000、16000、32000、44100、48000。

返回值Copy Anchor Link

• 0: 方法调用成功。
• < 0: 方法调用失败。 详见 错误码 了解详情和解决建议。

StartRecordingDeviceTestCopy Anchor Link

启动音频采集设备测试。

public abstract int StartRecordingDeviceTest(int indicationInterval);

详情Copy Anchor Link

该方法用于测试本地音频采集设备是否能正常工作。调用该方法后，SDK 会按设置的时间间隔触发 OnAudioVolumeIndication 回调，报告 uid = 0 及采集设备的音量信息。

该方法和 StartEchoTest 的区别在于该方法检测本地的音频采集设备能否正常工作，后者可以检测音视频设备及网络是否正常。

参数Copy Anchor Link

indicationIntervalCopy Anchor Link

SDK 触发 OnAudioVolumeIndication 回调的时间间隔，单位为毫秒，最小取值为 10，否则会收不到 OnAudioVolumeIndication 回调，SDK 会返回错误码 -2。声网推荐你将该值设为 100。

返回值Copy Anchor Link

• 0: 方法调用成功。
• < 0: 方法调用失败。 详见 错误码 了解详情和解决建议。
  • -2: 参数设置错误，请重新设置参数。

StopAudioDeviceLoopbackTestCopy Anchor Link

停止音频设备回路测试。

public abstract int StopAudioDeviceLoopbackTest();

详情Copy Anchor Link

返回值Copy Anchor Link

• 0: 方法调用成功。
• < 0: 方法调用失败。 详见 错误码 了解详情和解决建议。

StopPlaybackDeviceTestCopy Anchor Link

停止音频播放设备测试。

public abstract int StopPlaybackDeviceTest();

详情Copy Anchor Link

该方法用于停止音频播放设备测试。调用 StartPlaybackDeviceTest 后，必须调用该方法停止测试。

返回值Copy Anchor Link

• 0: 方法调用成功。
• < 0: 方法调用失败。 详见 错误码 了解详情和解决建议。

StopRecordingDeviceTestCopy Anchor Link

停止音频采集设备测试。

public abstract int StopRecordingDeviceTest();

详情Copy Anchor Link

该方法用于停止音频采集设备测试。调用 StartRecordingDeviceTest 后，必须调用该方法停止测试。

返回值Copy Anchor Link

• 0: 方法调用成功。
• < 0: 方法调用失败。 详见 错误码 了解详情和解决建议。

OnAudioDeviceStateChangedCopy Anchor Link

音频设备变化回调。

public virtual void OnAudioDeviceStateChanged(string deviceId, MEDIA_DEVICE_TYPE deviceType, MEDIA_DEVICE_STATE_TYPE deviceState) { }

提示系统音频设备状态发生改变，比如耳机被拔出。

参数Copy Anchor Link

deviceIdCopy Anchor Link

设备 ID。

deviceTypeCopy Anchor Link

设备类型定义。详见 MEDIA_DEVICE_TYPE。

deviceStateCopy Anchor Link

设备状态，详见 MEDIA_DEVICE_STATE_TYPE。

OnAudioDeviceVolumeChangedCopy Anchor Link

音频设备或 App 的音量发生改变回调。

public virtual void OnAudioDeviceVolumeChanged(MEDIA_DEVICE_TYPE deviceType, int volume, bool muted)

当音频播放、采集设备或 App 的音量发生改变时，会触发该回调。

参数Copy Anchor Link

deviceTypeCopy Anchor Link

设备类型定义。详见 MEDIA_DEVICE_TYPE。

volumeCopy Anchor Link

音量。范围为 [0,255]。

mutedCopy Anchor Link

音频设备是否为静音状态：

• true: 音频设备已静音。
• false: 音频设备未被静音。