提交工单
咨询集成、功能及报价等问题
屏幕共享是指在视频通话或互动直播过程中将屏幕内容以视频的方式分享给其他的观众,以增强互动体验,提高沟通效率。
屏幕共享在如下场景中应用广泛:
请参考 下载示例源码 获取源码。
相关源码请查看 “/ZegoExpressExample/Others/src/main/java/com/example/others/screensharing” 目录下的文件。
others
...
├── screensharing
│ ├── ScreenSharingActivity.java
...
在实现屏幕共享功能之前,请确保:
下图展示了 Android 平台实现屏幕共享的数据流转:
如果您想自己实现屏幕共享功能,请参考 如何通过自定义采集实现屏幕共享?。
在工程的 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>
SDK 推流的视频源默认为摄像头源,如果需要推屏幕共享源,需要通过 setVideoSource 切换为屏幕共享。
engine.setVideoSource(ZegoVideoSourceType.ZEGO_VIDEO_SOURCE_SCREEN_CAPTURE, ZegoPublishChannel.MAIN);
调用 startScreenCapture 接口共享整个系统的画面。
engine.startScreenCapture();
调用 stopScreenCapture 接口停止共享。
engine.stopScreenCapture();
调用 loginRoom 接口,传入房间 ID 参数 “roomID” 和用户参数 “user”,登录房间。
调用 startPublishingStream 接口,传入流 ID 参数 “streamID”,向远端用户发送本端的音视频流。
/** 创建用户 */
ZegoUser user = new ZegoUser("user1");
/** 开始登录房间 */
engine.loginRoom("room1", user);
/** 开始推流 */
engine.startPublishingStream("stream1");
至此,我们已完成采集屏幕数据并通过 ZegoExpress SDK 分享到远端的操作。
完成以上步骤之后,其他用户可以使用 startPlayingStream 接口拉取屏幕共享流。
// 拉流播放,需传入发起屏幕共享的用户推流时所用的 streamID
engine.startPlayingStream(streamID, new ZegoCanvas(playView));
联系我们
文档反馈