tencent cloud

文档反馈

Electron

最后更新时间:2022-07-21 16:57:07

    本文档主要介绍如何使用屏幕分享,目前一个 TRTC 音视频房间只能有一路屏幕分享。

    Electron 平台下的屏幕分享支持主路分享和辅路分享两种方案:

    • 辅路分享
      在 TRTC 中,我们可以单独为屏幕分享开启一路上行的视频流,并称之为“辅路(substream)”。辅路分享即主播同时上行摄像头画面和屏幕画面两路画面。这是腾讯会议的使用方案,您可以在调用 startScreenCapture 接口时,通过将 TRTCVideoStreamType 参数指定为 TRTCVideoStreamTypeSub 来启用该模式。

    • 主路分享
      在 TRTC 中,我们一般把摄像头走的通道叫做“主路(bigstream)”,主路分享即用摄像头通道分享屏幕。该模式下,主播只有一路上行视频流,要么上行摄像头画面,要么上行屏幕画面,两者是互斥的。您可以在调用 startScreenCapture 接口时,通过将 TRTCVideoStreamType 参数指定为 TRTCVideoStreamTypeBig 来启用该模式。

    步骤1:获取分享目标

    通过 getScreenCaptureSources 可以枚举可共享的窗口列表,列表通过出参 sourceInfoList 返回。

    说明:

    Electron 里的桌面屏幕也是一个窗口,叫桌面窗口(Desktop),有两台显示器时,每一台显示器都有一个对应的桌面窗口。所以,getScreenCaptureSources 返回的窗口列表里也会有 Desktop 窗口。

    根据获取到的窗口信息,您可以实现一个简单的列表页面,将可以分享的目标罗列出来供用户选择。

    import TRTCCloud from 'trtc-electron-sdk';
    const rtcCloud = new TRTCCloud();
    // https://web.sdk.qcloud.com/trtc/electron/doc/en-us/trtc_electron_sdk/TRTCCloud.html#getScreenCaptureSources
    const screenList = rtcCloud.getScreenCaptureSources();
    

    步骤2:开始屏幕分享

    import TRTCCloud, { 
    Rect, TRTCScreenCaptureProperty, TRTCVideoStreamType, TRTCVideoEncParam,
    TRTCVideoResolution, TRTCVideoResolutionMode
    } from 'trtc-electron-sdk';
    const rtcCloud = new TRTCCloud();
    // https://web.sdk.qcloud.com/trtc/electron/doc/zh-cn/trtc_electron_sdk/TRTCCloud.html#getScreenCaptureSources
    const screenList = rtcCloud.getScreenCaptureSources();
    // https://web.sdk.qcloud.com/trtc/electron/doc/zh-cn/trtc_electron_sdk/Rect.html
    const captureRect = new Rect(0, 0, 0, 0);
    // https://web.sdk.qcloud.com/trtc/electron/doc/zh-cn/trtc_electron_sdk/TRTCScreenCaptureProperty.html
    const property = new TRTCScreenCaptureProperty(
    true, true, true, 0, 0, false
    );
    if (screenList.length > 0) {
    rtcCloud.selectScreenCaptureTarget(screenList[0], captureRect, property)
    }
    const screenshareDom = document.querySelector('screen-dom');
    // https://web.sdk.qcloud.com/trtc/electron/doc/zh-cn/trtc_electron_sdk/TRTCVideoEncParam.html
    const encParam = new TRTCVideoEncParam(
    TRTCVideoResolution.TRTCVideoResolution_1920_1080,
    TRTCVideoResolutionMode.TRTCVideoResolutionModeLandscape,
    15,
    2000,
    0,
    false
    ); 
    rtcCloud.startScreenCapture(screenshareDom, TRTCVideoStreamType.TRTCVideoStreamTypeSub, encParam);
    

    步骤3:设定画面质量

    您可以通过 startScreenCapture 接口的第三个参数 encParam 设定屏幕分享的画面质量(参见 步骤2),包括分辨率、码率和帧率,我们提供如下建议参考值:

    清晰度级别 分辨率 帧率 码率
    超高清(HD+) 1920 × 1080 10 2000kbps
    高清(HD) 1280 × 720 10 600kbps
    标清(SD) 960 × 720 10 400kbps

    步骤4:观看屏幕分享

    当房间里有一个用户启动了屏幕分享,会通过辅流进行分享。房间里的其他用户会通过 onUserSubStreamAvailable 事件获得这个通知。
    希望观看屏幕分享的用户可以通过 startRemoteView 接口来启动渲染远端用户辅流画面。

    import TRTCCloud, { 
    TRTCVideoStreamType
    } from 'trtc-electron-sdk';
    const rtcCloud = new TRTCCloud();
    const remoteDom = document.querySelector('.remote-user');
    function onUserSubStreamAvailable(userId, available) {
    if (available === 1) {
    rtcCloud.startRemoteView(userId, remoteDom, TRTCVideoStreamType.TRTCVideoStreamTypeSub);
    } else {
    rtcCloud.stopRemoteView(userId, TRTCVideoStreamType.TRTCVideoStreamTypeSub);
    }
    }
    rtcCloud.on('onUserSubStreamAvailable', onUserSubStreamAvailable);
    

    常见问题

    1. 一个房间里可以同时有多路屏幕分享吗?

    目前一个 TRTC 音视频房间只能有一路屏幕分享。

    2. 指定窗口分享(SourceTypeWindow),当窗口大小变化时,视频流的分辨率会不会也跟着变化?

    默认情况下,SDK 内部会自动根据分享的窗口大小进行编码参数的调整。
    如需固定分辨率,需调用 setSubStreamEncoderParam 接口设置屏幕分享的编码参数,或在调用 startScreenCapture 时指定对应的编码参数。

    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持