摄像头采集

startCameraCapture

开始通过摄像头采集视频。

C++

virtual int startCameraCapture(VIDEO_SOURCE_TYPE sourceType, const CameraCapturerConfiguration& config) = 0;

自从

v4.2.0

调用该方法可以通过指定 sourceType 同时开启多路摄像头采集。

注： 在 iOS 平台上调用该方法前，如果要开启多路摄像头采集，需要在调用该方法前，先调用 enableMultiCamera 并设置 enabled 为 true。

参数

参数名	描述
sourceType	视频源的类型。详见 VIDEO_SOURCE_TYPE。 注： 移动端最多支持 2 路摄像头采集的视频流 (要求设备支持双摄或者支持外接摄像头)。 桌面端最多支持 4 路摄像头采集的视频流。
config	视频采集配置。详见 CameraCapturerConfiguration。 注： 在 iOS 平台上，该参数无实际作用。请使用 enableMultiCamera 中的 config 参数设置视频采集配置。

所属接口类

• IRtcEngine

stopCameraCapture

停止通过摄像头采集视频。

C++

virtual int stopCameraCapture(VIDEO_SOURCE_TYPE sourceType) = 0;

自从

v4.2.0

调用 startCameraCapture 开启一路或多路摄像头采集的视频流后，你可以调用该方法，通过设置 sourceType 停止一路或多路摄像头的视频采集。

注： 在 iOS 平台上，如果要关闭多路摄像头采集，需要在调用该方法之后调用 enableMultiCamera 并设置 enabled 为 false。 注意： 如果你正在使用本地合图功能，调用该方法停止通过第一个摄像头采集视频，会造成本地合图中断。

参数

参数名	描述
sourceType	视频源的类型，详见 VIDEO_SOURCE_TYPE。

返回值

• 0: 方法调用成功。

• < 0: 方法调用失败。详见错误码了解详情和解决建议。

所属接口类

• IRtcEngine