startPreview method

Future<void> startPreview(
  1. {ZegoCanvas? canvas,
  2. ZegoPublishChannel? channel}
)

启动/更新本地预览,支持设置其他通道的推流。

支持版本:1.1.0 及以上。 详情描述:用户通过调用此函数可以看到自己本地的画面。 业务场景:可以用于实时连麦、直播等场景下的本地预览。 调用时机:调用 createEngine 后。 使用限制:无。 注意事项:1. 预览功能不需要先登录房间或推流,但是在退出房间之后 SDK 内部默认会主动停止预览。2. 可以通过再次调用此函数来切换视图或修改预览模式(ZegoViewMode)。用户只能在一个视图上预览,如果再次调用 startPreview 传入新的视图,则预览画面只会在新视图展现。3. 可以通过调用 setVideoMirrorMode 函数来设置预览画面的镜像模式,移动端默认开启预览画面的镜像效果。4. 调用此函数后,SDK 会启动音视频引擎,并尝试采集音频与视频。 注意:此函数仅在 ZegoExpressVideo SDK 中有效!

  • canvas 启动预览时用于显示画面的视图,视图设置为 null 则不进行预览。
  • channel 推流通道

Implementation

Future<void> startPreview(
    {ZegoCanvas? canvas, ZegoPublishChannel? channel}) async {
  return await ZegoExpressImpl.instance
      .startPreview(canvas: canvas, channel: channel);
}