switchSrc abstract method

Future<void> switchSrc({
  1. required String src,
  2. bool syncPts = true,
})

切换媒体资源。

你可以根据当前网络状态调用该方法切换播放的媒体资源的码率。例如： 在网络较差时，将播放的媒体资源切换为较低码率的媒体资源地址。 在网络较好时，将播放的媒体资源切换为较高码率的媒体资源地址。 调用该方法后，如果你收到 onPlayerEvent 回调报告事件 playerEventSwitchComplete ，则媒体资源切换成功。如果资源切换失败，SDK 会自动重试 3 次。如果仍然失败，你会收到 onPlayerEvent 回调，报告 playerEventSwitchError 事件，表示媒体资源切换时发生错误。 请确保在 open 之后调用该方法。 为保证播放正常，请在调用该方法时注意如下： 不要在播放暂停时调用该方法。 不要在切换码率过程中调用 seek 。 确保切换码率前的播放位置不大于待切换的媒体资源总时长。

  • src 媒体资源的网络路径。
  • syncPts 是否同步切换前后的起始播放位置: true ：同步。 false ：(默认) 不同步。

Returns 方法成功调用时，无返回值；方法调用失败时，会抛出 AgoraRtcException 异常，你需要捕获异常并进行处理。详见错误码了解详情和解决建议。

Implementation

Future<void> switchSrc({required String src, bool syncPts = true});