enableLocalVideo abstract method
开启或关闭本地视频的采集与发送。
通过本接口可以实现开启或关闭本地视频,不影响接收远端视频。
调用时机
请在初始化后调用该方法,且该方法在加入房间前后均可调用。
说明
- 纯音频 SDK 禁用该接口,如需使用请前往云信官网下载并替换成视频 SDK。
- 该方法设置内部引擎为开启或关闭状态, 在 leaveChannel 后仍然有效。
- 在您的应用切到后台或者其他应用占用摄像头时,可能会导致摄像头打开失败,需要注册 camera 动态权限,详细信息请参考添加权限。 参数说明
enable
是否开启本地视频采集与发送:
- true: 开启本地视频采集。
- false : 关闭本地视频采集。关闭后,远端用户无法接收到本地用户的视频流;但本地用户仍然可以接收到远端用户的视频流。
streamType
视频通道类型:
* main(0):主流。
* sub(1):辅流。
相关回调
- 开启本地视频采集后,远端会收到 NERtcChannelEventCallback.onUserVideoStart 回调。
- 关闭本地视频采集后,远端会收到 NERtcChannelEventCallback.onUserVideoStop 回调。
返回值
- 0(OK):方法调用成功。
- 其他:方法调用失败。
- 30001(errorFatal):重复入会或获取房间信息失败。
- 30005(invalidState):状态错误,比如引擎尚未初始化。
- 30011(createDeviceSourceFail):创建设备源失败,未获取到操作系统的摄像头权限。
Implementation
Future<int> enableLocalVideo(bool enable,
{int streamType = NERtcVideoStreamType.main});