多摄像头模式
功能描述
在通话过程中,有时候需要展示不同方向或者角度的画面让频道内的其他人也看到,比如美术教学场景等,Cloudhub提供以下面方法可以满足多摄像头模式的需求。
开始前请确保已在你的项目中实现基本的实时音视频功能。详见开始音视频通话。
多摄像头模式通常指拥有多个视频采集设备。多摄像头模式方法主要用来采集和播放不同方向或者角度的画面。 CloudHub SDK 提供统一管理多摄像头模式,包含一些管理摄像头的常用方法。 内部使用 sourceId 来识别和视频。保证每个视频设备有唯一性。
实现参考
Android
- 在初始化RtcEnginePlus->initEngineAPI时,启用多摄像头以模式。
- 可通过getLocalCameraIds获取本地摄像头列表
- 开启本地视频设备采集->enableLocalVideo,传入需要启用设备的cameraId
- 播放本视频流->startPlayingLocalVideo,传入对应视频设备的cameraId
- 停止本视频流->stopPlayingLocalVideo,传入对应视频设备的cameraId
- 发布本视频流->publishStream,传入需要发布视频设备的cameraId
- 停止发布本视频流->unpublishStream,传入需要停止发布视频设备的cameraId
Web
- 创建客户端
- enableMultiStream 启用多流模式
- 加入频道
- getDevices 获取输入 / 输出设备
- createStream 创建
Stream
对象, 可传不同的 sourceID - 传入
Stream
对象, publish 发布本地音视频流(多流需要多次创建Stream
,多次发布) - unpublish 取消发布本地音视频流(传入哪个
Stream
,取消发布哪一路视频流)
开发注意事项
多摄像头模式支持PC客户端、PC浏览器、android设备。iOS设备只接受多摄像头视频流,不支持发布多摄像头流。
以上方法都有返回值,返回值小于 0 表示方法调用失败。