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