startVideoCapture method
@detail api
@hiddensdk(audiosdk)
@author zhangzhenyu.samuel
@brief 立即开启内部视频采集。默认为关闭状态。
内部视频采集指:使用 RTC SDK 内置视频采集模块,进行采集。
调用该方法后,本地用户会收到 onVideoDeviceStateChanged{@link #IRTCEngineEventHandler#onVideoDeviceStateChanged} 的回调。
本地用户在非隐身状态下调用该方法后,房间中的其他用户会收到 onUserStartVideoCapture{@link #IRTCEngineEventHandler#onUserStartVideoCapture} 的回调。
@return
- 0: 调用成功。
- < 0 : 调用失败。查看 ReturnStatus{@link #ReturnStatus} 获得更多错误说明
@note
- 自 v3.37.0 版本,使用本接口需要在 Gradle 里引入 Kotlin。
- 调用 stopVideoCapture{@link #RTCEngine#stopVideoCapture} 可以停止内部视频采集。否则,只有当销毁引擎实例时,内部视频采集才会停止。
- 创建引擎后,无论是否发布视频数据,你都可以调用该方法开启内部视频采集。只有当(内部或外部)视频采集开始以后视频流才会发布。
- 如果需要从自定义视频采集切换为内部视频采集,你必须先停止发布流,关闭自定义采集,再调用此方法手动开启内部采集。
- 内部视频采集使用的摄像头由 switchCamera{@link #RTCEngine#switchCamera} 接口指定。
- 你还可以联系技术支持人员,帮助你在服务端配置采集格式并下发到 Android 端。
Implementation
FutureOr<int> startVideoCapture() async {
return await nativeCall('startVideoCapture', []);
}