音频设备管理
- iOS
更新时间不可用
startPlaybackDeviceTest:
启动本地音频播放设备测试。
- (int)startPlaybackDeviceTest:(NSString * _Nonnull)audioFileName NS_SWIFT_NAME(startPlaybackDeviceTest(_:));该方法用于测试本地音频播放设备是否正常工作。调用该方法后,SDK 会播放你指定的音频文件。如果你能听到声音,说明播放设备工作正常。
注: 请在加入频道前调用该方法。测试完成后,在加入频道前调用 stopPlaybackDeviceTest 停止测试。
相关回调
成功调用该方法后,SDK 会每 100 毫秒触发一次 rtcEngine:reportAudioVolumeIndicationOfSpeakers:totalVolume: 回调,报告 uid 为 1 的播放设备音量信息。
参数
返回值
- 0:方法调用成功。
- < 0:方法调用失败。详见错误码了解详情和解决建议。
所属接口类
startRecordingDeviceTest:
启动音频采集设备测试。
- (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
停止音频播放设备测试。
- (int)stopPlaybackDeviceTest NS_SWIFT_NAME(stopPlaybackDeviceTest());调用 startPlaybackDeviceTest: 方法开始测试后,必须调用此方法停止测试。
注: 请在加入频道前调用此方法。
返回值
- 0:方法调用成功。
- < 0:方法调用失败。详见错误码了解详情和解决建议。
所属接口类
stopRecordingDeviceTest
停止音频采集设备测试。
- (int)stopRecordingDeviceTest NS_SWIFT_NAME(stopRecordingDeviceTest());该方法用于停止音频采集设备测试。你必须在调用 startRecordingDeviceTest 方法后调用此方法以停止测试。
注: 请在加入频道前调用此方法。
返回值
- 0:方法调用成功。
- < 0:方法调用失败。详见错误码了解详情和解决建议。