屏幕共享

---

1 功能简介

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

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

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

2 示例源码下载

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

相关源码请查看 “/ZegoExpressExample/Others/src/main/java/com/example/others/screensharing” 目录下的文件。

others
...
├── screensharing
│   ├── ScreenSharingActivity.java
...

3 前提条件

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

• 支持 Android 5.0 或以上版本，且支持音视频的 Android 设备或模拟器（推荐使用真机）。
• 已在项目中集成 ZEGO Express SDK，实现基本的实时音视频功能，详情请参考 快速开始 - 集成 和 快速开始 - 实现视频通话。
• 已在 ZEGO 控制台 创建项目，并申请有效的 AppID 和 AppSign，详情请参考 控制台 - 项目管理 中的“项目信息”。

4 实现流程

下图展示了 Android 平台实现屏幕共享的数据流转：

4.1 获取用户录制屏幕授权

在工程的 AndroidManifest.xml 文件中，增加屏幕录制的权限配置。

<uses-permission android:name="android.permission.FOREGROUND_SERVICE"/>

<application>
   <activity
        android:name="im.zego.internal.screencapture.ZegoScreenCaptureManager$ZegoScreenCaptureAssistantActivity"
        android:exported="false"
        android:configChanges="screenSize|orientation"
        android:screenOrientation="fullUser"
        android:theme="@android:style/Theme.Translucent" />
    <service
        android:name="im.zego.internal.screencapture.ZegoScreenCaptureService"
        android:enabled="true"
        android:exported="false"
        android:foregroundServiceType="mediaProjection">
        <intent-filter>
        <action android:name="android.intent.action.screenshare" />
        </intent-filter>
    </service>
</application>

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

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

engine.setVideoSource(ZegoVideoSourceType.ZEGO_VIDEO_SOURCE_SCREEN_CAPTURE, ZegoPublishChannel.MAIN);

4.3 开启屏幕共享

调用 startScreenCapture 接口共享整个系统的画面。

engine.startScreenCapture();

4.4 停止屏幕共享

调用 stopScreenCapture 接口停止共享。

engine.stopScreenCapture();

4.5 登录房间并开始推流

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

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

/** 创建用户 */
ZegoUser user = new ZegoUser("user1");

/** 开始登录房间 */
engine.loginRoom("room1", user);  
/** 开始推流 */
engine.startPublishingStream("stream1");  

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

5 观看远端屏幕共享

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

// 拉流播放，需传入发起屏幕共享的用户推流时所用的 streamID
engine.startPlayingStream(streamID, new ZegoCanvas(playView));