音视频通话

屏幕共享配置

功能介绍

在开始屏幕共享前,可通过屏幕共享配置接口指定共享源(显示器、窗口或区域),以及编码参数。

1. 设置屏幕共享配置

使用 setScreenShareCfg 设置屏幕共享配置。

const rtcsdk = new RTCSDK();

// 共享指定显示器
const cfg = { monitorID: 0 };
rtcsdk.setScreenShareCfg(JSON.stringify(cfg));

// 共享指定窗口(可搭配 getScreenCaptureSources 获取 windowID)
const cfg2 = { catchWnd: windowID };
rtcsdk.setScreenShareCfg(JSON.stringify(cfg2));

// 共享指定区域
const cfg3 = {
    catchRect: { left: 0, top: 0, width: 1920, height: 1080 },
    monitorID: 0 // 指定区域所在屏幕
};
rtcsdk.setScreenShareCfg(JSON.stringify(cfg3));

如果 monitorID、catchWnd、catchRect 都没传入,则是无效的配置。如果在传入 catchWnd 或 catchRect 的情况下又传入了 monitorID 参数,则共享窗口或区域时,超出 monitorID 屏幕的区域不会被共享。

2. 获取屏幕共享配置

const rtcsdk = new RTCSDK();
const cfg = rtcsdk.getScreenShareCfg();

3. 获取屏幕共享信息

const rtcsdk = new RTCSDK();
const info = rtcsdk.getScreenShareInfo();

相关 API 请参考: