推送视频流
功能介绍
本节介绍如何将本端视频画面推送到房间,使其他参会者能看到本端的画面,包括:
- 开/关视频与视频状态
- 默认视频与多路视频
- 与视频设备管理、视频图像质量的配合
注意:
成功进入房间后,才可以推送视频流;
1. 打开与关闭视频
成功进入房间后,打开视频就代表着本端已开启推送(缺省开启的只有默认视频设备),如需要开启多路视频设备,参见 同时推送多路视频流。
开启推送时并不立即发送数据到网络,只有在房间内其他人订阅打开的视频,或服务器有录制需求时,SDK 才会对被订阅视频设备进行采集编码发送。
- 打开视频:调用 openVideo(userID),传入本端用户 ID(SDK也支持打开他人视频)。
- 关闭视频:调用 closeVideo(userID),停止采集与发送。
- 视频开关状态:在房间内开关视频时,房间内所有人会收到notifyVideoStatusChanged通知。 对于后进入房间的人,可以通过getAllMembers得到已经在房间人员的视频打开状态。
示例:
CRVideoSDKMeeting& meeting = g_sdkMain->getSDKMeeting();
std::string myUserID = "12345678";
// 打开本端视频,向房间推送画面
meeting.openVideo(myUserID.c_str());
// 关闭本端视频,停止推送
meeting.closeVideo(myUserID.c_str());
相关 API 请参考:
2. 视频推流质量配置
视频质量配置:分辨率、帧率、码率等由 setVideoCfg 配置,详见 视频推流质量配置。
3. 效果与美颜
- 视频效果:镜像、旋转、降噪等通过 setVideoEffects 配置,详见 视频图像镜像旋转、视频降噪。
- 美颜 / 虚拟背景:仅对默认视频设备生效,参见 美颜、虚拟背景。
更多能力参见: