屏幕共享

2025-01-20

功能简介

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

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

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

示例源码下载

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

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

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

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

前提条件

在实现屏幕共享功能之前，请确保：

Visual Studio 2013 或以上版本。
Windows7、Windows8、Windows10 或以上版本。
已在 ZEGO 控制台创建项目，并申请有效的 AppID 和 AppSign，详情请参考控制台 - 项目信息。
已在项目中集成 ZEGO Express SDK，并实现了基本的音视频推拉流功能，详情请参考快速开始 - 集成和快速开始 - 实现流程。

实现流程

注意

屏幕采集时，仅 iOS、Android 平台支持同时采集视频和音频；其他平台仅支持采集视频，如需采集音频，请开发者自行实现相关逻辑。
如果您已经通过 ZEGO 旧版屏幕共享产品实现屏幕共享功能，或者需要自己实现屏幕共享功能，请参考如何通过自定义采集实现屏幕共享？。

获取窗口（包括屏幕）列表信息

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

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

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

创建屏幕共享源

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

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

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

设置采集源为屏幕共享源

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

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

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

启动共享

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

source->startCapture();

source->startCapture();

更新共享源

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

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

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

更新共享源区域

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

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

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

过滤指定窗口

调用 setExcludeWindowList 接口可以过滤掉共享的屏幕中指定窗口画面，只适用于共享整个屏幕的时候设置。

void* list[2];
list[0] = infoList[1].sourceID
list[1] = infoList[2].sourceID
source->setExcludeWindowList(list, 2);

void* list[2];
list[0] = infoList[1].sourceID
list[1] = infoList[2].sourceID
source->setExcludeWindowList(list, 2);

是否激活窗口

调用 enableWindowActivate 接口可以激活当前共享的窗口。

source->enableWindowActivate(true);

source->enableWindowActivate(true);

是否显示鼠标

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

source->enableCursorVisible(true);

source->enableCursorVisible(true);

设置事件回调

调用 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 onCaptureTypeExceptionOccurred(IZegoScreenCaptureSource * /*source*/, ZegoScreenCaptureSourceType /*sourceType*/, ZegoScreenCaptureSourceExceptionType /*exceptionType*/) override;

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

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 onCaptureTypeExceptionOccurred(IZegoScreenCaptureSource * /*source*/, ZegoScreenCaptureSourceType /*sourceType*/, ZegoScreenCaptureSourceExceptionType /*exceptionType*/) override;

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

登录房间并开始推流

调用 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);

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

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

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

观看远端屏幕共享

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

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

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

停止共享

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

source->stopCapture();

source->stopCapture();

销毁屏幕采集源对象

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

engine->destroyScreenCaptureSource(source);

engine->destroyScreenCaptureSource(source);