音频设备管理

  • iOS

更新时间不可用

startPlaybackDeviceTest:

启动本地音频播放设备测试。

Objective-C
- (int)startPlaybackDeviceTest:(NSString * _Nonnull)audioFileName NS_SWIFT_NAME(startPlaybackDeviceTest(_:));

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

注: 请在加入频道前调用该方法。测试完成后,在加入频道前调用 stopPlaybackDeviceTest 停止测试。

相关回调

成功调用该方法后,SDK 会每 100 毫秒触发一次 rtcEngine:reportAudioVolumeIndicationOfSpeakers:totalVolume: 回调,报告 uid 为 1 的播放设备音量信息。

参数

参数名描述
audioFileName

音频文件的路径。数据格式为 UTF-8 编码的字符串。

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

返回值

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

所属接口类

startRecordingDeviceTest:

启动音频采集设备测试。

Objective-C
- (int)startRecordingDeviceTest:(int)indicationInterval NS_SWIFT_NAME(startRecordingDeviceTest(_:));

该方法用于测试音频采集设备是否正常工作。调用该方法后,SDK 会按照设置的时间间隔触发 rtcEngine:reportAudioVolumeIndicationOfSpeakers:totalVolume: 回调,报告 uid 为 0 的本地采集设备的音量信息。该方法与 startEchoTestWithConfig: 方法的区别在于,startRecordingDeviceTest: 仅检测本地音频采集设备是否正常工作,而 startEchoTestWithConfig: 可以检测音视频设备和网络状况。

注: 请在加入频道前调用该方法。测试完成后,在加入频道前调用 stopRecordingDeviceTest 停止测试。

参数

参数名描述
indicationInterval

触发 rtcEngine:reportAudioVolumeIndicationOfSpeakers:totalVolume: 回调的时间间隔(毫秒)。该值应大于 10,否则你将无法收到 rtcEngine:reportAudioVolumeIndicationOfSpeakers:totalVolume: 回调,且 SDK 返回错误码 -2。声网建议设置为 100。

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

返回值

  • 0:方法调用成功。

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

    • -2:参数无效。请检查参数设置。

所属接口类

stopPlaybackDeviceTest

停止音频播放设备测试。

Objective-C
- (int)stopPlaybackDeviceTest NS_SWIFT_NAME(stopPlaybackDeviceTest());

调用 startPlaybackDeviceTest: 方法开始测试后,必须调用此方法停止测试。

注: 请在加入频道前调用此方法。

返回值

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

所属接口类

stopRecordingDeviceTest

停止音频采集设备测试。

Objective-C
- (int)stopRecordingDeviceTest NS_SWIFT_NAME(stopRecordingDeviceTest());

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

注: 请在加入频道前调用此方法。

返回值

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

所属接口类