屏幕共享

---

功能简介

屏幕共享，是指在视频通话或互动直播过程中将屏幕内容以视频的方式分享给其他的观众，以增强互动体验，提高沟通效率。

屏幕共享在如下场景中应用广泛：

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

示例源码下载

请参考 下载示例源码 获取源码。

相关源码请查看 “/ZegoExpressExample/Example/Others/ScreenSharing/” 目录下的文件。

others
...
├── ScreenSharing
│   ├── ScreenCaptureSourceDialog.cpp // 展示可共享的窗口略缩图
│   ├── ScreenCaptureSourceDialog.h
│   ├── ScreenCaptureSourceDialog.ui
│   ├── ScreenSharing.cpp // 屏幕共享主流程功能
│   ├── ScreenSharing.h
│   └── ScreenSharing.ui
...

前提条件

如需在 Linux 端实现屏幕共享功能，请联系 ZEGO 技术支持。

实现流程

1 创建屏幕共享源

1. SDK 可以通过 getScreenCaptureSources 获取当前可共享的所有窗口信息。

   IZegoExpressEngine *engine = ZegoExpressSDK::getEngine();
   std::vector<ZegoScreenCaptureSourceInfo> infoList = engine->getScreenCaptureSources(400, 400, 100, 100);

2. 通过上述窗口信息里的窗口 ID 与窗口类型，调用 createScreenCaptureSource 接口创建屏幕共享源对象。

   if (infoList.size() > 0) {
       ZegoScreenCaptureSourceInfo info = infoList[0];
       IZegoScreenCaptureSource *source = engine->createScreenCaptureSource(info.sourceID, info.sourceType);
   }

2 设置采集源为屏幕共享源

SDK 推流的视频源默认为摄像头源，如果需要推屏幕共享源，需要通过 setVideoSource 进行切换为屏幕共享。

engine->setVideoSource(ZEGO_VIDEO_SOURCE_SCREEN_CAPTURE, source->getIndex(), ZEGO_PUBLISH_CHANNEL_MAIN);

3 启动共享

调用 startCapture 接口可以共享窗口画面。

source->startCapture();

4 （可选）附加操作

• 更新共享源
  调用 updateCaptureSource 接口可以更新共享窗口画面。

  ZegoScreenCaptureSourceInfo info = infoList[1];
  source->updateCaptureSource(info.sourceID, info.sourceType);

• 更新共享源区域
  调用 updateCaptureRegion 接口可以动态更新共享窗口区域。其中设置为 (0, 0, 0, 0) 可恢复整个窗口共享。

  source->updateCaptureRegion(10, 10, 400, 400);

• 是否激活窗口
  若需要采集的窗口被其他窗口挡住，可以调用 enableWindowActivate 接口，将需要采集的窗口放到最前面，以激活当前共享的窗口。

  source->enableWindowActivate(true);

• 是否显示鼠标
  调用 enableCursorVisible 接口可以显示或隐藏鼠标。

  source->enableCursorVisible(true);

5 设置事件回调

调用 setEventHandler 接口可以设置共享源事件回调。

std::shared_ptr<ScreenCaptureSourceEventHandler> handler = std::make_shared<ScreenCaptureSourceEventHandler>(this);
source->setEventHandler(handler);

···
// 采集数据回调，可用于本地录制。
void onAvailableFrame(IZegoScreenCaptureSource * /*source*/, const void * /*data*/,unsigned int /*dataLength*/, ZegoVideoFrameParam /*param*/) override;

// 采集异常回调，当有异常回调时，会中断采集。
void onExceptionOccurred(IZegoScreenCaptureSource * /*source*/,ZegoScreenCaptureSourceExceptionType /*exceptionType*/) override;

// 窗口采集状态回调，当窗口区域位置更改时，会通过此回调通知，当窗口不在当前屏幕区域内时，会停止采集。
void onWindowStateChanged(IZegoScreenCaptureSource * /*source*/,ZegoScreenCaptureWindowState /*windowState*/,ZegoRect /*windowRect*/) override;

6 登录房间并开始推流

调用 loginRoom 接口，传入房间 ID 参数 “roomID” 和用户参数 “user”，登录房间。

调用 startPublishingStream 接口，传入流 ID 参数 “streamID”，向远端用户发送本端的音视频流。

// 开始登录房间
ZegoUser user(m_currentUserId, m_currentUserId);
engine->loginRoom(m_currentRoomId, user);

// 开始推流
engine->startPublishingStream(m_currentPublishStreamId, ZEGO_PUBLISH_CHANNEL_MAIN);

至此，我们已完成采集屏幕数据并通过 ZEGO Express SDK 分享到远端的操作。

7 观看远端屏幕共享

完成以上步骤之后，其他用户可以使用 startPlayingStream 接口拉取屏幕共享流。

ZegoCanvas canvas(ZegoUtilHelper::GetView(ui->frame_Play));
canvas.viewMode = ZEGO_VIEW_MODE_ASPECT_FIT;
engine->startPlayingStream(m_currentPlayStreamId, &canvas);

8 停止共享

用户可以调用 stopCapture 接口停止共享。

source->stopCapture();

9 销毁屏幕采集源对象

不再需要使用屏幕采集功能时，可调用 destroyScreenCaptureSource 接口销毁屏幕采集源对象。

engine->destroyScreenCaptureSource(source);