startVideoCapture method
@detail api
@hiddensdk(audiosdk)
@author zhangzhenyu.samuel
@brief 立即开启内部视频采集。默认为关闭状态。
内部视频采集指:使用 RTC SDK 内置视频采集模块,进行采集。
调用该方法后,本地用户会收到 rtcEngine:onVideoDeviceStateChanged:device_type:device_state:device_error:{@link #ByteRTCEngineDelegate#rtcEngine:onVideoDeviceStateChanged:device_type:device_state:device_error} 的回调。
非隐身用户进房后调用该方法,房间中的其他用户会收到 rtcEngine:onUserStartVideoCapture:info:{@link #ByteRTCEngineDelegate#rtcEngine:onUserStartVideoCapture:info} 的回调。
@return
- 0: 调用成功。
- < 0 : 调用失败。查看 ByteRTCReturnStatus{@link #ByteRTCReturnStatus} 获得更多错误说明
@note
- 调用 stopVideoCapture{@link #ByteRTCEngine#stopVideoCapture} 可以停止内部视频采集。否则,只有当销毁引擎实例时,内部视频采集才会停止。
- 创建引擎后,无论是否发布视频数据,你都可以调用该方法开启内部视频采集。只有当(内部或外部)视频采集开始以后视频流才会发布。
- 如果需要从自定义视频采集切换为内部视频采集,你必须先停止发布流,关闭自定义采集,再调用此方法手动开启内部采集。
- 内部视频采集使用的摄像头由 switchCamera:{@link #ByteRTCEngine#switchCamera} 接口指定。(macOS 不支持)
- 自 v3.37.0 升级版本,你需要在应用中向用户申请摄像头权限后才能开始采集。
Implementation
FutureOr<int> startVideoCapture() async {
return await nativeCall('startVideoCapture', []);
}