屏幕共享
功能介绍
在视频会话中为了提高沟通效率,可以将自己的屏幕内容分享给其他参与方观看。还支持在屏幕上进行标注,以及授权其他参与方进行远程控制。
注意:
小程序端限制: 由于微信小程序未提供屏幕采集相关 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 请参考:
相关组件请参考: