屏幕分享

BRTC 支持屏幕分享，即将当前系统的屏幕内容通过 BRTC SDK 分享给房间里的其他用户。
屏幕分享不但支持“辅路分享”， 也支持使用”主视频流“进行分享。使用主路视频流屏幕分享时，摄像头的采集建议先停止，否则会相互冲突。 屏幕共享功能需要在加入房间后，再调用相应函数启动或者关闭。

百家云 SDK 的屏幕共享特性可提供以下功能，适用于各种场景下的屏幕共享。

• 共享整个屏幕

将你的整个屏幕进行共享，包括屏幕中的所有信息，该功能支持同时采集两块屏幕的信息并共享。

• 共享应用窗口

  如果你不希望将整个屏幕内容分享给其他用户，可以只共享一个应用程序窗口画面。

• 共享指定区域

  如果你只希望共享屏幕或应用程序窗口中的一部分，可以在开启屏幕共享时设置一个共享区域，只有该区域内的画面会被分享。

获取资源列表

调用 getScreenCaptureSources，获取可共享的屏幕和窗口的对象列表，列表中包含窗口 ID 和屏幕 ID 等重要信息。方便用户通过列表中的缩略图选择共享某个显示器的屏幕或某个窗口。

// 获取指定的可共享窗口或屏幕的信息。
BRTCScreenCaptureSourceList* wndInfoList = m_pBrtc->getScreenCaptureSources(SIZE{120, 70}, SIZE{20, 20});
for (size_t i = 0; i < wndInfoList->getCount(); i++) {
  // 返回可共享窗口或屏幕的信息
  BRTCScreenCaptureSourceInfo info = wndInfoList->getSourceInfo(static_cast<uint32_t>(i));
}
wndInfoList->release();

开启屏幕分享

根据实际应用场景，在以下 3 种屏幕共享方式中任选一种。

• 共享整个屏幕

// 指定共享整个屏幕，rect 设为 { 0, 0, 0, 0 }
m_pBrtc->selectScreenCaptureTarget(BRTCScreenCaptureSourceTypeScreen, info.sourceId, rect, property);
m_pBrtc->startScreenCapture(nullptr, BRTCVideoStreamTypeSub, nullptr);

• 共享屏幕指定区域

// 指定共享整个屏幕的指定区域，rect 设为 { 10, 20, 300, 300 }
m_pBrtc->selectScreenCaptureTarget(BRTCScreenCaptureSourceTypeScreen, info.sourceId, rect, property);
m_pBrtc->startScreenCapture(nullptr, BRTCVideoStreamTypeSub, nullptr);

• 共享应用程序窗口

// 指定共享的 app 窗口，rect 设为 { 0, 0, 0, 0 }
m_pBrtc->selectScreenCaptureTarget(BRTCScreenCaptureSourceTypeWindow, info.sourceId, rect, property);
m_pBrtc->startScreenCapture(nullptr, BRTCVideoStreamTypeSub, nullptr);

更新共享区域或参数

在房间内，你可以调用如下方法动态更新屏幕共享区域或参数。

• 如果你要更新屏幕共享的区域，调用 selectScreenCaptureTarget 方法，重新设置 rect 参数、划定新的共享区域。
• 如果你要更新屏幕共享的参数（是否采集鼠标？是否高亮显示正在共享的窗口？是否对屏幕或 应用程序窗口描边？是否采集子窗口等），更新 selectScreenCaptureTarget 函数中的 property 参数的配置。

// 指定共享窗口的指定区域，rect 设为 { 10, 10, 100, 200 }
m_pBrtc->selectScreenCaptureTarget(BRTCScreenCaptureSourceTypeWindow, info.sourceId, rect, property);

对屏幕描边

在房间内，你可以修改参数值对共享区域或者窗口描边。 将 BRTCScreenCaptureProperty 中的 enableHighLight 设置为 true，并同时设置 highLightColor 和 highLightWidth 来指定描边的颜色和宽度。

BRTCScreenCaptureProperty property = uiShareSelect.getProperty();
property.enableHighLight = true;
property.highLightColor = 0xFFFF0000;
property.highLightWidth = 15;
// 指定共享 app 窗口的指定区域，rect 设为 { 10, 10, 100, 200 }
m_pBrtc->selectScreenCaptureTarget(BRTCScreenCaptureSourceTypeWindow, info.sourceId, rect, property);

停止屏幕共享

调用 stopScreenCapture 停止屏幕共享。

// 停止屏幕共享
m_pBrtc->stopScreenCapture();

设定视频编码参数

通过设置 startScreenCapture 中的参数 encParams ，您可以指定屏幕分享的编码质量。如果您指定 encParams 为 null，SDK 会自动选择最佳的编码参数，我们推荐的参数设定如下：

• 由于屏幕分享的内容一般不会剧烈变动，所以设置较高的 FPS 并不经济，通常 fps 设置 10 即可
• 如果您要分享的屏幕内容包含大量文字，可以适当提高分辨率和码率设置
• 最高码率是指画面在剧烈变化时的最高输出码率，如果屏幕内容变化较少，实际编码码率会变得很低，这是正常现象，也是屏幕共享区别于普通视频的特点

观看屏幕分享

当推流端使用 startScreenCapture 接口开启屏幕分享后，存在以下一些情况：

• 如果 startScreenCapture 传入的流类型是 BRTCVideoStreamTypeBig：
  • 当前尚未推摄像头流，那么其他用户会收到 onUserVideoAvailable 回调通知。之后用户可以通过调用 startRemoteView 接口来显示此屏幕共享画面。
  • 如果当前摄像头已经在推流了，那么其他用户看到的摄像头画面将被替换为屏幕共享画面。不会再有新的事件产生
• 如果 startScreenCapture 传入的流类型是 BRTCVideoStreamTypeSub：
  • 无论当前是否有摄像头流在推流，其他用户都会收到 onUserSubStreamAvailable 回调通知。之后用户可以通过调用 startRemoteView 接口来显示此屏幕共享画面。