startLocalVideoTranscoder abstract method

Future<void> startLocalVideoTranscoder(
  1. LocalTranscoderConfiguration config
)

开启本地合图。

调用该方法后，你可以在本地将多路视频流合并为一路视频流。例如：将摄像头采集的视频流、屏幕共享流、媒体播放器中的视频流、远端视频流、视频文件、图片等合并为一路视频流，然后将已合图的视频流发布到频道中。 本地合图对 CPU 的消耗较高，声网建议你在性能较高的设备上开启该功能。 如果你需要对本地采集的视频流进行合图，SDK 支持如下采集组合： 在 Windows 平台上，最多支持 4 路摄像头采集的视频流 + 4 路屏幕共享流合图。 在 macOS 平台上，最多支持 4 路摄像头采集的视频流 + 1 路屏幕共享流合图。 在 Android 和 iOS 平台上，最多支持 2 路摄像头采集的视频流（需要设备本身支持双摄或支持外接摄像头）+ 1 路屏幕共享合图。 在进行合图配置时，需确保采集人像的摄像头视频流在合图中的图层编号大于屏幕共享流的图层编号，否则人像会被屏幕共享覆盖、无法显示在最终合图的视频流中。

  • config 本地合图的配置，详见 LocalTranscoderConfiguration 。 参与本地合图的每一路视频流的分辨率最大为 4096 × 2160，如果超出此限制，会导致合图不生效。 合图后的视频流最大分辨率为 4096 × 2160。

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

Implementation

Future<void> startLocalVideoTranscoder(LocalTranscoderConfiguration config);