# 屏幕共享

功能简介:
在视频会话中为了提高沟通效率，可以将自己的屏幕内容分享给其他参与方观看。还支持在屏幕上进行标注，以及授权其他参与方进行远程控制。当屏幕共享者开启标注后，控件就进入标注模式。此时，房间内所有用户都可以进行标注，并观看他人标注的内容。
使用场景如下：

视频会议场景中，屏幕共享可以将讲话者本地的文件、数据、网页、PPT 等画面分享给其他与会人；
在线课堂场景中，屏幕共享可以将老师的课件、笔记、讲课内容等画面展示给学生观看。

注意：同一个房间中，不支持多人同时开启屏幕共享。

共享端：

开始共享
停止共享

观看端：

观看共享的屏幕
屏幕共享停止通知

#

共享端

1.开始共享

使用接口启动共享，出现共享内容显示组件后，用组件上的功能开始标注和结束共享。

接口调用：

/*
*开启屏幕共享分为2步：
*/

//1.开启屏幕共享
CRVideo_StartScreenShare();

//2.用户根据浏览器弹窗选择所需要的屏幕窗口共享或者应用程序

回调通知：

// 主动开启屏幕共享的结果
CRVideo_StartScreenShareRslt.callback = function (sdkErr){
    if(sdkErr == 0){ //主动开启共享成功
        console.log("主动开启共享成功");
    } else {
        console.log("主动开启共享失败，错误码：" + sdkErr);
    }
}

相关API请参考：

2.停止共享

接口调用：

//主动停止屏幕共享
CRVideo_StopScreenShare()

回调通知：

//主动停止屏幕共享的结果
CRVideo_StopScreenShareRslt.callback = function (sdkErr){
    if(sdkErr == 0){ //主动停止共享成功
        console.log("主动停止共享成功");
    } else {
        console.log("主动停止共享失败，错误码：" + sdkErr);
    }
}

相关API请参考：

1.观看共享的屏幕

回调通知：

//收到他人开启了屏幕共享的通知，此时可以观看他人的屏幕
CRVideo_NotifyScreenShareStarted.callback = function (sharer) {
    var screenShareObj = CRVideo_CreatScreenShareObj(); //创建屏幕共享显示组件
    document.body.appendChlid(screenShareObj.handler());    //添加到页面任意位置
    screenShareObj.setVideo(sharer);    //需要将视频挂在在ui组件上

    var nicknameStyle = {
        display: "block"
        left: "10px",
        top: "10px",
        backgroundColor: "rgba(0, 0, 0, .7)",
        padding: "0 10px",
        borderRadius: "15px",
    }

    screenShareObj.setNickNameStyle(nicknameStyle); // 设置昵称样式
    screenShareObj.setNickNameContent(CRVideo_GetMemberNickName(sharer) + "'s screen"); //设置昵称
}

相关API请参考：

CRVideo_NotifyScreenShareStarted

2.屏幕共享停止通知

回调通知：

//收到他人停止了屏幕共享的通知，即停止观看（此时可以隐藏屏幕共享控件）
CRVideo_NotifyScreenShareStopped.callback = function(){
    //销毁屏幕共享控件。 示例代码：
    document.body.removeChlid(screenShareObj.handler())
    screenShareObj.destory();
    screenShareObj = null;
}

相关API请参考：

CRVideo_NotifyScreenShareStopped