音视频通话

订阅并显示视频

功能介绍

本节介绍如何在房间内订阅并显示视频画面。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. 了解更多视频订阅方式