订阅并显示视频
功能介绍
本节介绍如何在房间内订阅并显示视频画面。Electron SDK 通过 createVideoUI 创建视频观看组件,将视频渲染到指定的 HTML 容器中。
1. 订阅与取消订阅
- 订阅时机: 自已进入房间成功后才能发起订阅操作。 被订阅者也必须是房间内人员(参见getAllMembers、notifyUserEnterMeeting)。
- 订阅内容: 订阅时需要指定userID + videoID。videoID指定为-1时,代表订阅对方的默认摄像头。 用户当前启用的摄像头为:getDefaultVideo、getMutiVideos。
- 订阅:通过创建一个 VideoUI 组件,并设置userID + videoID即可完成订阅。其中他人的视频从服务器订阅,本地视频从本地采集模块订阅。
- 取消订阅:销毁 VideoUI 组件。
2. 创建视频观看组件
使用 createVideoUI 创建一个 VideoUI 组件实例,绑定到 HTML 容器元素上。
const rtcsdk = new RTCSDK();
// 构建一个 div 元素作为视频容器
const div = document.createElement('div');
document.body.appendChild(div);
// 创建视频观看组件
const videoUI = rtcsdk.createVideoUI(div, {
notifyFrameReceived(frame) {
console.log('收到了视频帧通知');
},
notifyFirstFrameRender() {
console.log('首帧渲染通知');
}
});
3. VideoUI 组件 API
- setVideo(videoObj):设置要观看的用户视频,videoObj 包含 type(观看类型)、userId(用户ID)、videoId(摄像头ID)等参数,详见 VideoUI.setVideo
- setConfig(videoCfg):设置视频组件的观看配置,如缩放类型等,详见 VideoUI.setConfig
- destroy():取消订阅和销毁组件
// 设置观看指定用户的默认视频
videoUI.setVideo({
type: 0,
userId: "user_123",
videoId: -1,
});
// 销毁视频组件(取消订阅)
videoUI.destroy();
相关 API 请参考:
4. 了解更多视频订阅方式
- 自定义视频渲染:通过 createCustomVideoDev + inputCustomVideoDat 实现自定义采集渲染,详见自定义视频采集/渲染。
- 所有视频设备信息:可通过 getAllVideoInfo 获取。