enableMultiCamera abstract method

Future<void> enableMultiCamera({
  1. required bool enabled,
  2. required CameraCapturerConfiguration config,
})

开启或关闭多路摄像头采集。

在已有摄像头采集视频的场景下,声网推荐你采用以下步骤实现多路摄像头采集、发布视频: 调用该方法开启多路摄像头采集。 调用 startPreview 开启本地视频预览。 调用 startCameraCapture 并设置 sourceType 指定第二个摄像头开始采集。 调用 joinChannelEx 并设置 publishSecondaryCameraTrack 为 true ,在频道内发布第二路摄像头采集的视频流。 如果要关闭多路摄像头采集,可参考以下步骤: 调用 stopCameraCapture 。 调用该方法并将 enabled 设置为 false 。 该方法仅适用于 iOS。 使用多路摄像头采集视频时,请确保系统版本为 13.0 及以上。 支持多路摄像头采集的最低 iOS 设备类型如下所示: iPhone XR iPhone XS iPhone XS Max iPad Pro (第三代及以上) 你可以在 startPreview 前后调用该方法开启多摄像头采集: 如果在 startPreview 之前开启,则本地视频预览会同时出现两个摄像头采集的画面。 如果在 startPreview 之后开启,SDK 会先停止当前的摄像头采集,然后再开启原摄像头和第二个摄像头,本地视频预览会出现短暂黑屏、然后自动恢复正常。

  • enabled 是否开启多摄像头视频采集模式: true :开启多摄像头采集模式,SDK 使用多路摄像头采集视频。 false :关闭多摄像头采集模式,SDK 仅使用单路摄像头采集视频。
  • config 第二个摄像头的采集配置。详见 CameraCapturerConfiguration 。

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

Implementation

Future<void> enableMultiCamera(
    {required bool enabled, required CameraCapturerConfiguration config});