音视频通话

屏幕共享

功能介绍

在视频会话中为了提高沟通效率,可以将自己的屏幕内容分享给其他参与方观看。还支持在屏幕上进行标注,以及授权其他参与方进行远程控制。

注意:

小程序端限制: 由于微信小程序未提供屏幕采集相关 API,小程序端不支持主动发起屏幕共享,仅能作为观看端接收和观看其他端(Windows、Android、iOS 等)发起的屏幕共享内容。
另外,小程序端也不支持主动发起屏幕标注和远程控制,仅能观看他人发起的标注内容。

1. 在页面配置中申明组件

在页面的 .json 配置文件中声明需要的组件:

{
    "usingComponents": {
        "RTCVideoPlayer": "/utils/RTCSDK/components/RTCVideoPlayer/RTCVideoPlayer",
        "RTCScreenMarkV4": "/utils/RTCSDK/components/RTCScreenMarkV4/RTCScreenMarkV4"
    }
}

2. 在页面中添加组件

<view class="father">
    <!-- 视频拉流组件,config 传入配置信息 -->
    <RTCVideoPlayer wx:if="{{mediaLayout}}" config="{{RTCScreenPlayer}}">
        <!-- 标注组件,有观看标注的需求可以引入 -->
        <RTCScreenMarkV4 class="cr-mark" wx:if="{{RTCScreenPlayer.type==='screen'}}" config="{{RTCScreenPlayer}}"></RTCScreenMarkV4>
    </RTCVideoPlayer>
</view>
.father {
    width: 300rpx;
    height: 100rpx;
    position: relative;
}
.cr-mark {
    position: absolute;
    z-index: 2;
    top: 0;
    left: 0;
    height: 100%;
    width: 100%;
}

3. 收到开启通知后渲染组件

// 其他端开启了屏幕共享,观看端收到通知
RTCSDK.NotifyScreenShareStarted.callback = function(userID) {
    this.setData({
        mediaLayout: true,
        RTCScreenPlayer: {
            userId: userID,
            type: 'screen',
            objectFit: 'contain'
        }
    });
}

4. 收到停止通知后销毁组件

// 屏幕共享停止通知
RTCSDK.NotifyScreenShareStopped.callback = function(userID) {
    this.setData({ mediaLayout: false });
}

相关 API 请参考:

相关组件请参考: