音频设备管理
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:方法调用失败。详见错误码了解详情和解决建议。