startEchoTest abstract method
开启音视频回路测试
在进房前,用户可调用该接口对音视频通话全链路进行检测,包括对音视频设备以及用户上下行网络的检测,从而帮助用户判断是否可以正常发布和接收音视频流。
开始检测后,SDK 会录制你声音或视频。如果你在设置的延时范围内收到了回放,则视为音视频回路测试正常。
delayTime
为音视频延迟播放的时间间隔,用于指定在开始检测多长时间后期望收到回放。取值范围为 [2,10]
,单位为秒,默认为 2 秒。
返回值:方法调用结果
- 0:成功
- -1:失败,当前用户已经在检测中
- -3:失败,音视频均未采集
- -4:失败,参数异常
- -5:失败,已经存在相同 roomId 的房间
注意:
- 调用该方法开始音视频回路检测后,你可以调用 RTCVideo.stopEchoTest 立即结束测试,也可等待测试 60s 后自动结束,以更换设备进行下一次测试,或进房。
- 在该方法之前调用的所有跟设备控制、流控制相关的方法均在开始检测时失效,在结束检测后恢复生效。
- 在调用 RTCVideo.startEchoTest 和 RTCVideo.stopEchoTest 之间调用的所有跟设备采集、流控制、进房相关的方法均不生效,并会收到 RTCVideoEventHandler.onWarning 回调。
- 音视频回路检测的结果会通过 RTCVideoEventHandler.onEchoTestResult 回调通知。
Implementation
Future<int?> startEchoTest({
required EchoTestConfig config,
required int delayTime,
});