需要访问旧版文档站？前往旧版文档官网首页。 (在新标签页打开)
声网文档中心

音频设备管理

  • Unreal C++

更新时间不可用

介绍跟音频设备管理相关的方法和回调。

enumeratePlaybackDevices

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

C++
virtual IAudioDeviceCollection* enumeratePlaybackDevices() = 0;

详情

注意： 该方法仅适用于 Windows 和 macOS。

该方法返回一个 IAudioDeviceCollection 对象，包含系统中所有的播放设备。通过 IAudioDeviceCollection 对象，App 可以枚举播放设备。在使用结束后，App 需调用 release 方法销毁返回的对象。

返回值

  • 方法调用成功：返回一个 IAudioDeviceCollection 对象，包含所有的音频播放设备。
  • 方法调用失败: NULL。

所属接口类

enumerateRecordingDevices

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

C++
virtual IAudioDeviceCollection* enumerateRecordingDevices() = 0;

详情

注意： 该方法仅适用于 Windows 和 macOS。

该方法返回一个 IAudioDeviceCollection 对象，包含系统中所有的音频采集设备。通过 IAudioDeviceCollection 对象，App 可以枚举音频采集设备。在使用结束后，App 需调用 release 方法销毁返回的对象。

返回值

  • 方法调用成功：返回一个 IAudioDeviceCollection 对象，包含所有的音频采集设备。
  • 方法调用失败: NULL。

所属接口类

followSystemLoopbackDevice

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

C++
virtual int followSystemLoopbackDevice(bool enable) = 0;

详情

方法仅适用于 Windows 和 macOS。

参数

参数名描述
enable

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

  • true：跟随。当系统默认播放设备发生改变时，SDK 立即跟随切换声卡采集设备。
  • false：不跟随。只有当 SDK 使用的声卡采集设备被移除后，SDK 才切换至系统默认的音频播放设备。
表格内容超出当前宽度，可横向滚动查看更多列。

返回值

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

所属接口类

followSystemPlaybackDevice

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

C++
virtual int followSystemPlaybackDevice(bool enable) = 0;

详情

注意： 该方法仅适用于 Windows 和 macOS。

参数

参数名描述
enable

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

  • true：跟随。当系统默认音频播放设备发生改变时，SDK 立即切换音频播放设备。
  • false：不跟随。只有当 SDK 使用的音频播放设备被移除后，SDK 才切换至系统默认的音频播放设备。
表格内容超出当前宽度，可横向滚动查看更多列。

返回值

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

所属接口类

followSystemRecordingDevice

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

C++
virtual int followSystemRecordingDevice(bool enable) = 0;

详情

注意： 该方法仅适用于 Windows 和 macOS。

参数

参数名描述
enable

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

  • true：跟随。当系统默认的音频采集设备改变时，SDK 立即切换音频采集设备。
  • false：不跟随。只有当 SDK 使用的音频采集设备被移除后，SDK 才切换至系统默认的音频采集设备。
表格内容超出当前宽度，可横向滚动查看更多列。

返回值

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

所属接口类

getApplicationVolume

获取 App 的当前音量。

C++
virtual int getApplicationVolume(int& volume) = 0;

参数

参数名描述
volume

App 当前的音量，取值范围为 [0,255]。

表格内容超出当前宽度，可横向滚动查看更多列。

返回值

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

所属接口类

getAudioDeviceInfo

获取音频设备信息。

C++
virtual int getAudioDeviceInfo(DeviceInfo& deviceInfo) = 0;

详情

调用该方法后，你可以获取音频设备是否支持极低延时采集和播放。

注意：

  • 该方法仅适用于 Android 平台。
  • 该方法在加入频道前后均可调用。

参数

参数名描述
deviceInfo

输入和输出参数。标识音频设备信息的 DeviceInfo 对象。

  • 输入值：一个 DeviceInfo 对象。
  • 输出值：一个包含了音频设备信息的 DeviceInfo 对象。
表格内容超出当前宽度，可横向滚动查看更多列。

返回值

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

所属接口类

getCount

获取播放或音频采集设备数量。

C++
virtual int getCount() = 0;

详情

如果先调用 enumeratePlaybackDevices 再调用该方法，返回播放设备的数量。如果先调用 enumerateRecordingDevices 再调用该方法，则返回音频采集设备的数量。

返回值

语音设备数目。

所属接口类

getDefaultDevice [1/2]

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

C++
virtual int getDefaultDevice(char deviceName[MAX_DEVICE_ID_LENGTH], char deviceId[MAX_DEVICE_ID_LENGTH]) = 0;

详情

参数

参数名描述
deviceName

输出参数，系统默认的音频设备名称。最大长度为 MAX_DEVICE_ID_LENGTH_TYPE。

deviceId

输出参数，系统默认的音频设备 ID。最大长度为 MAX_DEVICE_ID_LENGTH_TYPE。

表格内容超出当前宽度，可横向滚动查看更多列。

返回值

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

所属接口类

getDefaultDevice [2/2]

获取系统默认的音频设备及设备类型。

C++
virtual int getDefaultDevice(char deviceName[MAX_DEVICE_ID_LENGTH], char deviceTypeName[MAX_DEVICE_ID_LENGTH], char deviceId[MAX_DEVICE_ID_LENGTH]) = 0;

详情

参数

参数名描述
deviceName

输出参数，系统默认的音频设备名称。最大长度为 MAX_DEVICE_ID_LENGTH_TYPE。

deviceTypeName

输出参数，音频设备类型，如：built-in、USB、HDMI 等。最大长度为 MAX_DEVICE_ID_LENGTH_TYPE。

deviceId

输出参数，系统默认的音频设备 ID。最大长度为 MAX_DEVICE_ID_LENGTH_TYPE。

表格内容超出当前宽度，可横向滚动查看更多列。

返回值

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

所属接口类

getDevice [1/2]

获取指定 index 的音频设备信息。

C++
virtual int getDevice(int index, char deviceName[MAX_DEVICE_ID_LENGTH], char deviceId[MAX_DEVICE_ID_LENGTH]) = 0;

详情

该方法仅适用于 Windows 和 macOS。

参数

参数名描述
index

输入参数，指定想查询的设备信息。

deviceName

输出参数，设备名称。最大长度为 MAX_DEVICE_ID_LENGTH_TYPE。

deviceId

输出参数，设备 ID。最大长度为 MAX_DEVICE_ID_LENGTH_TYPE。

表格内容超出当前宽度，可横向滚动查看更多列。

返回值

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

所属接口类

getDevice [2/2]

获取指定 index 的音频设备信息及设备类型。

C++
virtual int getDevice(int index, char deviceName[MAX_DEVICE_ID_LENGTH], char deviceTypeName[MAX_DEVICE_ID_LENGTH],
                        char deviceId[MAX_DEVICE_ID_LENGTH]) = 0;

详情

你可以调用该方法获取指定音频设备的名称、设备类型及 ID。

注意： 该方法仅适用于 macOS 平台。

参数

参数名描述
index

输入参数，指定想查询的设备信息。

deviceId

输出参数，设备 ID。最大长度为 MAX_DEVICE_ID_LENGTH_TYPE。

deviceName

输出参数，设备名称。最大长度为 MAX_DEVICE_ID_LENGTH_TYPE。

deviceTypeName

输出参数，音频设备类型，如：built-in、USB、HDMI 等。最大长度为 MAX_DEVICE_ID_LENGTH_TYPE。

表格内容超出当前宽度，可横向滚动查看更多列。

返回值

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

所属接口类

getLoopbackDevice

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

C++
virtual int getLoopbackDevice(char deviceId[MAX_DEVICE_ID_LENGTH]) = 0;

详情

该方法仅适用于 Windows 和 macOS。

参数

参数名描述
deviceId

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

最大长度为 MAX_DEVICE_ID_LENGTH_TYPE。

表格内容超出当前宽度，可横向滚动查看更多列。

返回值

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

所属接口类

getPlaybackDevice

获取当前音频播放设备。

C++
virtual int getPlaybackDevice(char deviceId[MAX_DEVICE_ID_LENGTH]) = 0;

详情

注意： 该方法仅适用于 Windows 和 macOS。

参数

参数名描述
deviceId

输出参数，当前音频播放设备的设备 ID。最大长度为 MAX_DEVICE_ID_LENGTH_TYPE。

表格内容超出当前宽度，可横向滚动查看更多列。

返回值

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

所属接口类

getPlaybackDeviceInfo [1/2]

获取音频播放设备信息。

C++
virtual int getPlaybackDeviceInfo(char deviceId[MAX_DEVICE_ID_LENGTH], char deviceName[MAX_DEVICE_ID_LENGTH]) = 0;

详情

注意： 该方法仅适用于 Windows 和 macOS。

参数

参数名描述
deviceId

输出参数，播放设备的设备 ID。最大长度为 MAX_DEVICE_ID_LENGTH_TYPE。

deviceName

输出参数，播放设备的设备名称。最大长度为 MAX_DEVICE_ID_LENGTH_TYPE。

表格内容超出当前宽度，可横向滚动查看更多列。

返回值

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

所属接口类

getPlaybackDeviceInfo [2/2]

获取音频播放设备信息及其类型。

C++
virtual int getPlaybackDeviceInfo(char deviceId[MAX_DEVICE_ID_LENGTH], char deviceName[MAX_DEVICE_ID_LENGTH], char deviceTypeName[MAX_DEVICE_ID_LENGTH]) = 0;

详情

该方法仅适用于 macOS。

参数

参数名描述
deviceId

输出参数，播放设备的设备 ID。最大长度为 MAX_DEVICE_ID_LENGTH_TYPE。

deviceName

输出参数，播放设备的设备名称。最大长度为 MAX_DEVICE_ID_LENGTH_TYPE。

deviceTypeName

输出参数，音频播放设备类型，如：built-in、USB、HDMI 等。

表格内容超出当前宽度，可横向滚动查看更多列。

返回值

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

getPlaybackDeviceMute

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

C++
virtual int getPlaybackDeviceMute(bool *mute) = 0;

参数

参数名描述
mute

播放设备静音状态：

  • true: 播放设备为静音状态。
  • false: 播放设备为非静音状态。
表格内容超出当前宽度，可横向滚动查看更多列。

返回值

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

所属接口类

getPlaybackDeviceVolume

获取播放设备音量。

C++
virtual int getPlaybackDeviceVolume(int *volume) = 0;

参数

参数名描述
volume

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

表格内容超出当前宽度，可横向滚动查看更多列。

返回值

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

getRecordingDevice

获取当前音频采集设备。

C++
virtual int getRecordingDevice(char deviceId[MAX_DEVICE_ID_LENGTH]) = 0;

详情

注意： 该方法仅适用于 Windows 和 macOS。

参数

参数名描述
deviceId

输出参数。当前采集设备的设备 ID。最大长度为 MAX_DEVICE_ID_LENGTH_TYPE。

表格内容超出当前宽度，可横向滚动查看更多列。

返回值

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

所属接口类

getRecordingDeviceInfo [1/2]

获取音频采集设备信息。

C++
virtual int getRecordingDeviceInfo(char deviceId[MAX_DEVICE_ID_LENGTH], char deviceName[MAX_DEVICE_ID_LENGTH]) = 0;

详情

注意： 该方法仅适用于 Windows 和 macOS。

参数

参数名描述
deviceId

输出参数，播放设备的设备 ID。最大长度为 MAX_DEVICE_ID_LENGTH_TYPE。

deviceName

输出参数，播放设备的设备名称。最大长度为 MAX_DEVICE_ID_LENGTH_TYPE。

表格内容超出当前宽度，可横向滚动查看更多列。

返回值

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

所属接口类

getRecordingDeviceInfo [2/2]

获取音频采集设备信息及其类型。

C++
virtual int getRecordingDeviceInfo(char deviceId[MAX_DEVICE_ID_LENGTH], char deviceName[MAX_DEVICE_ID_LENGTH], char deviceTypeName[MAX_DEVICE_ID_LENGTH]) = 0;

详情

该方法仅适用于 macOS。

参数

参数名描述
deviceId

输出参数，播放设备的设备 ID。最大长度为 MAX_DEVICE_ID_LENGTH_TYPE。

deviceName

输出参数，播放设备的设备名称。最大长度为 MAX_DEVICE_ID_LENGTH_TYPE。

deviceTypeName

输出参数，音频采集设备类型，如：built-in、USB、HDMI 等。

表格内容超出当前宽度，可横向滚动查看更多列。

返回值

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

getRecordingDeviceMute

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

C++
virtual int getRecordingDeviceMute(bool *mute) = 0;

参数

参数名描述
mute

音频采集设备静音状态：

  • true: 采集设备为静音状态。
  • false: 采集设备为非静音状态。
表格内容超出当前宽度，可横向滚动查看更多列。

返回值

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

所属接口类

getRecordingDeviceVolume

获取音频采集设备音量。

C++
virtual int getRecordingDeviceVolume(int *volume) = 0;

详情

注： 该方法仅适用于 Windows 平台。

参数

参数名描述
volume

输出参数，音频采集设备音量，取值范围 [0,255]。

表格内容超出当前宽度，可横向滚动查看更多列。

返回值

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

所属接口类

isApplicationMute

获取 App 当前的静音状态。

C++
virtual int isApplicationMute(bool &mute) = 0;

参数

参数名描述
mute

App 当前是否静音：

  • true: App 为静音状态。
  • false: App 为非静音状态。
表格内容超出当前宽度，可横向滚动查看更多列。

返回值

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

所属接口类

release

释放 IAudioDeviceCollection 对象占用的所有资源。

C++
virtual void release() = 0;

所属接口类

release

释放 IAudioDeviceManager 对象占用的所有资源。

C++
virtual void release() = 0;

所属接口类

setApplicationMute

设置是否将 App 静音。

C++
virtual int setApplicationMute(bool mute) = 0;

参数

参数名描述
mute

是否将 App 设置为静音。

  • true: 将 App 静音。
  • false: 将 App 解除静音。
表格内容超出当前宽度，可横向滚动查看更多列。

返回值

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

所属接口类

setApplicationVolume

设置 App 音量。

C++
virtual int setApplicationVolume(int volume) = 0;

参数

参数名描述
volume

App 的音量，取值范围为 [0,255]。

表格内容超出当前宽度，可横向滚动查看更多列。

返回值

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

所属接口类

setDevice

指定音频设备。

C++
virtual int setDevice(const char deviceId[MAX_DEVICE_ID_LENGTH]) = 0;

详情

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

参数

参数名描述
deviceId

设备 ID。最大长度为 MAX_DEVICE_ID_LENGTH_TYPE。

表格内容超出当前宽度，可横向滚动查看更多列。

返回值

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

所属接口类

setLoopbackDevice

指定声卡采集设备。

C++
virtual int setLoopbackDevice(const char deviceId[MAX_DEVICE_ID_LENGTH]) = 0;

详情

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

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

注：

该方法仅适用于 Windows 和 macOS。

该方法适用的场景如下：

使用 App A 播放音乐，通过蓝牙耳机播放；同时使用 App B 进行视频会议，通过扬声器播放。

  • 如果设置声卡采集设备为蓝牙耳机，则 SDK 会将 App A 中的音乐发布到远端。
  • 如果设置声卡采集设备设置为扬声器，则 SDK 不会将 App A 中的音乐发布到远端。
  • 如果设置声卡采集设备为蓝牙耳机后，又改用有线耳机播放 App A 中的音乐，则需要重新调用该方法，设置声卡采集设备为有线耳机，则 SDK 会继续将 App A 中的音乐发布到远端。

参数

参数名描述
deviceId

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

最大长度为 MAX_DEVICE_ID_LENGTH_TYPE。

表格内容超出当前宽度，可横向滚动查看更多列。

返回值

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

所属接口类

setPlaybackDevice

指定播放设备。

C++
virtual int setPlaybackDevice(const char deviceId[MAX_DEVICE_ID_LENGTH]) = 0;

详情

注意： 该方法仅适用于 Windows 和 macOS。

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

参数

参数名描述
deviceId

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

最大长度为 MAX_DEVICE_ID_LENGTH_TYPE。

表格内容超出当前宽度，可横向滚动查看更多列。

返回值

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

所属接口类

setPlaybackDeviceMute

设置播放设备静音。

C++
virtual int setPlaybackDeviceMute(bool mute) = 0;

参数

参数名描述
mute

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

  • true: 播放设备设为静音。
  • false: 播放设备不设为静音。
表格内容超出当前宽度，可横向滚动查看更多列。

返回值

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

所属接口类

setPlaybackDeviceVolume

设置播放设备音量。

C++
virtual int setPlaybackDeviceVolume(int volume) = 0;

详情

注： 该方法仅适用于 Windows 平台。

参数

参数名描述
volume

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

表格内容超出当前宽度，可横向滚动查看更多列。

返回值

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

所属接口类

setRecordingDevice

指定音频采集设备。

C++
virtual int setRecordingDevice(const char deviceId[MAX_DEVICE_ID_LENGTH]) = 0;

详情

注意： 该方法仅适用于 Windows 和 macOS。

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

参数

参数名描述
deviceId

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

最大长度为 MAX_DEVICE_ID_LENGTH_TYPE。

表格内容超出当前宽度，可横向滚动查看更多列。

返回值

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

所属接口类

setRecordingDeviceMute

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

C++
virtual int setRecordingDeviceMute(bool mute) = 0;

参数

参数名描述
mute

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

  • true: 采集设备静音。
  • false: 采集设备为非静音。
表格内容超出当前宽度，可横向滚动查看更多列。

返回值

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

所属接口类

setRecordingDeviceVolume

设置音频采集设备音量。

C++
virtual int setRecordingDeviceVolume(int volume) = 0;

详情

该方法仅适用于 Windows 和 macOS。

参数

参数名描述
volume

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

表格内容超出当前宽度，可横向滚动查看更多列。

返回值

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

所属接口类

startAudioDeviceLoopbackTest

开始音频设备回路测试。

C++
virtual int startAudioDeviceLoopbackTest(int indicationInterval) = 0;

详情

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

注意：

  • 该方法仅适用于 Windows 和 macOS。
  • 该方法在加入频道前后都可调用。
  • 该方法仅支持主播角色调用。
  • 该方法仅在本地进行音频设备测试，不涉及网络连接。
  • 完成测试后，必须调用 stopAudioDeviceLoopbackTest 停止音频设备回路测试。

参数

参数名描述
indicationInterval

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

表格内容超出当前宽度，可横向滚动查看更多列。

返回值

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

所属接口类

startPlaybackDeviceTest

启动音频播放设备测试。

C++
virtual int startPlaybackDeviceTest(const char* testAudioFilePath) = 0;

详情

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

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

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

注意： 该方法需要在加入频道前调用。测试完成后，如需加入频道，请确保先调用 stopPlaybackDeviceTest 停止设备测试。

参数

参数名描述
testAudioFilePath

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

  • 支持文件格式: wav、mp3、m4a、aac。
  • 支持文件采样率: 8000、16000、32000、44100、48000。
表格内容超出当前宽度，可横向滚动查看更多列。

返回值

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

所属接口类

startRecordingDeviceTest

启动音频采集设备测试。

C++
virtual int startRecordingDeviceTest(int indicationInterval) = 0;

详情

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

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

注： 该方法需要在加入频道前调用。测试完成后，如需加入频道，请确保先调用 stopRecordingDeviceTest 停止设备测试。

参数

参数名描述
indicationInterval

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

表格内容超出当前宽度，可横向滚动查看更多列。

返回值

  • 0: 方法调用成功。

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

    • -2: 参数设置错误，请重新设置参数。

所属接口类

stopAudioDeviceLoopbackTest

停止音频设备回路测试。

C++
virtual int stopAudioDeviceLoopbackTest() = 0;

详情

注意：

  • 该方法仅适用于 Windows 和 macOS。
  • 该方法在加入频道前后都可调用。
  • 该方法仅支持主播角色调用。
  • 在调用 startAudioDeviceLoopbackTest 后，必须调用该方法停止音频设备回路测试。

返回值

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

所属接口类

stopPlaybackDeviceTest

停止音频播放设备测试。

C++
virtual int stopPlaybackDeviceTest() = 0;

详情

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

注意： 该方法需要在加入频道前调用。

返回值

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

所属接口类

stopRecordingDeviceTest

停止音频采集设备测试。

C++
virtual int stopRecordingDeviceTest() = 0;

详情

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

注： 该方法需要在加入频道前调用。

返回值

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

所属接口类

onAudioDeviceStateChanged

音频设备变化回调。

C++
virtual void onAudioDeviceStateChanged(const char* deviceId,
     int deviceType,
     int deviceState) {
     (void)deviceId;
     (void)deviceType;
     (void)deviceState;
     }

详情

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

注： 该方法仅适用于 Windows 和 macOS。

参数

参数名描述
deviceId

设备 ID。

deviceType

设备类型定义。详见 MEDIA_DEVICE_TYPE。

deviceState

设备状态，详见 MEDIA_DEVICE_STATE_TYPE。

表格内容超出当前宽度，可横向滚动查看更多列。

所属接口类

onAudioDeviceVolumeChanged

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

C++
virtual void onAudioDeviceVolumeChanged(MEDIA_DEVICE_TYPE deviceType, int volume, bool muted) {
    (void)deviceType;
    (void)volume;
    (void)muted;
  }

详情

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

注： 该回调仅适用于 Windows 和 macOS。

参数

参数名描述
deviceType

设备类型定义。详见 MEDIA_DEVICE_TYPE。

volume

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

muted

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

  • true: 音频设备已静音。
  • false: 音频设备未被静音。
表格内容超出当前宽度，可横向滚动查看更多列。

所属接口类

咨询电话

400 632 6626

上海声网科技有限公司

Copyright © 2026 声网保留所有权利