startMixerTask method

Future<ZegoMixerStartResult> startMixerTask(
  1. ZegoMixerTask task
)

开始混流任务。

支持版本：1.2.1 及以上。 详情描述：向 ZEGO RTC 服务器发起混流请求，服务器会寻找当前正在推的流，并根据 SDK 请求的混流任务的参数进行图层混合。当需要更新混流任务时，即输入流增加或减少时需要更新输入流列表，此时可以更新 ZegoMixerTask 对象 inputList 的字段并再次调用本函数传入相同的 ZegoMixerTask 对象更新混流任务。 业务场景：常用于需要多个视频画面合成一个视频时使用混流，比如教育类，直播老师和学生的画面。 调用时机：调用 loginRoom 登录房间后。 使用限制：无。 注意事项：由于客户端设备的性能考虑，SDK 的混流是在 ZEGO RTC 服务器开启混流任务进行混流。若请求开启混流任务发生异常，例如最常见的混流的输入流不存在，将会从 callback 回调的错误码给出。具体错误码请参考 常见错误码文档 https://doc-zh.zego.im/zh/4378.html 若中途某条输入流不存在了，混流任务会自动重试拉这条输入流 90 秒，90 秒之后不再重试。若所有输入流均不存在了，90秒之后服务器会自动停止混流任务。 相关回调：可通过 onMixerRelayCDNStateUpdate 获取混流转推 CDN 状态更新通知，可通过 onMixerSoundLevelUpdate 获取混流中的每条单流的声浪更新通知。 相关接口：可通过 stopMixerTask 函数停止混流。

  • task 混流任务对象。是否必填：是。
  • Returns 开始混流任务结果

Implementation

Future<ZegoMixerStartResult> startMixerTask(ZegoMixerTask task) async {
  return await ZegoExpressImpl.instance.startMixerTask(task);
}