Android如何实现两台手机屏幕共享和远程控制？最新 SDK 接入教程

笔者简介

长期关注 RTC 实时音视频领域的技术演进，参与过音视频算法工程化、接入实现与效果评估等相关工作。

在实际项目中，持续关注包括腾讯 TRTC、即构 ZEGO、 声网 Agora 在内的多家 RTC 厂商在实时通信能力与工程落地层面的实践，重点关注 SDK 接入、通话链路实现与场景化应用。系列文章将围绕 RTC SDK 接入与实时互动能力实现，持续输出工程实践与场景分析。

本文重点关注 Android 端音视频能力实现、屏幕共享与远程控制等典型场景。主要基于最新版本的 ZEGO SDK 接入文档整理，对部分接入流程和配置方式进行了更新。

1 功能简介

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

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

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

2 屏幕共享示例源码下载

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

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

others
└── screensharing
    └── ScreenSharingActivity.java
...

3 前提条件

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

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

4 实现流程

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

4.1（必选）获取用户录制屏幕授权

在工程的 AndroidManifest.xml 文件中，增加屏幕录制的权限配置。设置完成后，在录制屏幕前，会弹窗提示用户是否允许应用录制屏幕，需要用户手动授权。

1. 屏幕录制功能依赖于前台服务保活，进入您项目的 “app/src/main” 目录，打开 “AndroidManifest.xml” 文件，添加权限声明。

   1. 如果目标 Android SDK 版本低于 34.0.0 版本，需设置 FOREGROUND_SERVICE 权限声明。

<!---->

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

如果目标 Android SDK 版本是 34.0.0 及以后版本，需要设置 FOREGROUND_SERVICE 及 FOREGROUND_SERVICE_MEDIA_PROJECTION 权限声明。

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

2. 声明屏幕录制的前台服务和辅助 Activity。

注意

• 如果您使用的是 3.6.0 或以上版本的 SDK，且通过 Maven 自动集成（或手动集成 “.aar” 包）时，可以跳过此步骤。
• 如果您使用的是 3.6.0 以下版本的 SDK，必须手动声明屏幕录制的前台服务和辅助 Activity，否则无法启动屏幕录制。

<!---->

<application>
<activity
        android:name="im.zego.internal.screencapture.ZegoScreenCaptureManager$ZegoScreenCaptureAssistantActivity"
        android:exported="false"
        android:configChanges="screenSize|orientation"
        android:screenOrientation="behind"
        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.SCREEN_CAPTURE, ZegoPublishChannel.MAIN);

SDK 推流的“音频源”默认为麦克风，如果需要推屏幕共享源，需要通过 setAudioSource 切换为屏幕共享。

engine.setAudioSource(ZegoAudioSourceType.SCREEN_CAPTURE, ZegoPublishChannel.MAIN);

4.3 开启屏幕共享

调用 startScreenCapture 接口共享整个系统的画面、采集第三方应用的音频。

engine.startScreenCapture();

开发者还可以使用 ZegoScreenCaptureConfig 参数设置是否采集视频、是否采集音频、设置音频采集时的采样率和采样通道等。

ZegoScreenCaptureConfig config = new ZegoScreenCaptureConfig();
config.captureVideo = true;
config.captureAudio = true;
config.audioParam.sampleRate = ZegoAudioSampleRate.ZEGO_AUDIO_SAMPLE_RATE_16K;
config.audioParam.channel = ZegoAudioChannel.STEREO;
// 可选参数，设置视频的采集区域，必须在原始的视频数据之内，单位为像素（px）
config.cropRect = new Rect(left, top, right, bottom);

engine.startScreenCapture(config);

4.3.1 设置屏幕共享朝向

屏幕共享朝向支持跟随系统朝向和固定朝向，默认跟随系统朝向。可以设置 ZegoScreenCaptureConfig 中的 orientation 参数来设置屏幕共享朝向。

ZegoScreenCaptureConfig config = new ZegoScreenCaptureConfig();
...
config.orientation = ZegoScreenCaptureOrientation.LANDSCAPE; // 固定横屏
engine.startScreenCapture(config);

4.4 更新屏幕共享配置

调用 updateScreenCaptureConfig 接口，可以更新屏幕共享的配置。

ZegoScreenCaptureConfig config = new ZegoScreenCaptureConfig();
config.captureVideo = true;
config.captureAudio = false;
config.audioParam.sampleRate = ZegoAudioSampleRate.ZEGO_AUDIO_SAMPLE_RATE_32K;
config.audioParam.channel = ZegoAudioChannel.STEREO;
config.orientation = ZegoScreenCaptureOrientation.PORTRAIT; // 固定竖屏
// 可选参数，设置视频的采集区域，必须在原始的视频数据之内，单位为像素（px）
config.cropRect = new Rect(left, top, right, bottom);

engine.updateScreenCaptureConfig(config);

4.5 监听屏幕共享回调通知

开发者需要监听 IZegoEventHandler 类中的以下回调：

• onScreenCaptureStart 回调，接收开始屏幕采集成功的通知，方便做后续业务处理，如 UI 提示或应用跳转等。
• onScreenCaptureExceptionOccurred 回调，接收屏幕共享过程中的异常信息通知，从而可分析屏幕共享失败的原因。

<!---->

public void setEngineEventHandler(){
    engine.setEventHandler(new IZegoEventHandler() {
        @Override
        public void onScreenCaptureExceptionOccurred(ZegoScreenCaptureExceptionType exceptionType) {
            super.onScreenCaptureExceptionOccurred(exceptionType);
            AppLogger.getInstance().receiveCallback("screen capture exception occurred: %s", exceptionType);
        }
        @Override
        public void onScreenCaptureStart() {
            super.onScreenCaptureStart();
            AppLogger.getInstance().receiveCallback("screen capture start");
        }
    });
}

4.6 登录房间并开始推流

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

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

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

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

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

4.7 观看远端屏幕共享

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

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

4.8 停止屏幕共享

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

engine.stopScreenCapture();

5 获取屏幕共享 SDK 更多帮助

如果你在接入过程中遇到问题，可以参考下方常见问题或官方文档进一步排查。

近期有项目规划，可以了解 RTC 产品报价，或点击官网右侧联系商务咨询折扣。

6 Android 屏幕共享常见问题（FAQ）

1. Android 屏幕共享时出现黑屏或闪屏，是什么原因？

问题描述： 开启屏幕共享后，画面短暂显示后变黑，或频繁闪屏。

常见原因：

• 横竖屏切换导致采集异常（最常见）
• 系统权限未完全授予
• 部分厂商 ROM（如 MIUI / EMUI）限制后台采集

解决方案：

• 保持 App 与设备方向一致（避免强制横竖屏冲突）
• 检查是否正确获取 MediaProjection 权限
• 避免频繁切换 Activity 或重建采集实例

2. Android 设备固定竖屏时，屏幕共享弹窗方向异常怎么办？

问题描述： 开启屏幕共享时，系统授权弹窗方向异常，甚至导致黑屏。

原因： 设备固定竖屏与 App 横屏界面冲突，引发系统数据异常。

解决方案：

• 修改 AndroidManifest 中 SDK Activity 的 screenOrientation 为 unspecified
• 使用 tools:replace 覆盖默认配置
• 或开启系统自动旋转功能

3. Android 屏幕共享为什么没有声音？

问题描述： 共享画面正常，但对方听不到系统声音或应用声音。

常见原因：

• 未开启系统音频采集（Android 10+ 才支持）
• 使用普通麦克风采集，未使用系统音频通道
• 部分应用（如 DRM 视频）禁止音频采集

解决方案：

• 使用系统音频采集接口（AudioPlaybackCapture API）
• 确认 targetSdkVersion ≥ 29
• 避免采集受保护内容（如 Netflix）

4. Android 屏幕共享画面卡顿或延迟高怎么办？

问题描述： 共享画面卡顿、不流畅或延迟明显。

常见原因：

• 编码参数设置过高（分辨率 / 帧率）
• 网络带宽不足或波动
• 设备性能不足（尤其是低端机）

解决方案：

• 降低分辨率（如 720p → 480p）
• 限制帧率（建议 10–15fps）
• 使用硬件编码（H.264 / H.265）

5. Android 屏幕共享时出现崩溃（Crash）如何排查？

问题描述： 开启或停止屏幕共享时应用崩溃。

常见原因：

• MediaProjection 生命周期管理错误
• 重复创建 VirtualDisplay
• 未正确释放资源

解决方案：

• 确保 MediaProjection 只初始化一次
• 在 onStop 中释放 VirtualDisplay
• 避免多线程同时操作采集对象

6. Android 屏幕共享为什么分辨率异常或画面拉伸？

问题描述： 共享画面比例不对，出现拉伸或压缩。

常见原因：

• 采集分辨率与设备实际分辨率不匹配
• 横竖屏切换未同步更新参数

解决方案：

• 动态获取设备分辨率（DisplayMetrics）
• 横竖屏切换时重新配置采集参数
• 保持宽高比一致（如 16:9）

7. Android 屏幕共享权限弹窗无法弹出怎么办？

问题描述： 调用屏幕共享时，没有出现系统授权弹窗。

常见原因：

• Context 使用错误（非 Activity）
• 权限请求流程异常
• 被系统或厂商 ROM 拦截

解决方案：

• 确保使用 Activity 调用 MediaProjectionManager
• 检查 startActivityForResult 流程
• 在前台触发权限请求

8. Android 屏幕共享在后台被中断怎么办？

问题描述： 切到后台后，屏幕共享自动停止。

常见原因：

• 系统省电策略限制
• 未使用前台服务（Foreground Service）
• 厂商系统强杀进程

解决方案：

• 使用 Foreground Service 保活
• 关闭电池优化（Doze 模式）
• 针对厂商机型做适配（白名单机制）

9. Android 屏幕共享如何实现远程控制（反向操作）？

问题描述： 不仅要共享屏幕，还需要远程控制另一台设备。

核心难点：

• Android 原生不支持直接远程控制
• 需要额外输入注入能力（Accessibility / ADB）

解决方案：

• 结合 AccessibilityService 实现点击/滑动注入
• 或通过 ADB / 无障碍服务实现控制能力
• 通常需配合实时音视频 SDK 传输控制信号

10. Android 屏幕共享在不同厂商设备上表现不一致怎么办？

问题描述： 不同品牌手机（如小米、华为、OPPO）表现差异明显。

原因：

• ROM 定制导致权限和后台策略不同
• 编码能力差异（硬件编码支持不同）

解决方案：

• 建立机型兼容性测试列表
• 针对主流厂商做专项适配
• 使用 SDK 内置兼容策略（如 ZEGO 即构、声网 Agora、腾讯云 TRTC）

本文主要介绍了 Android 设备之间实现屏幕共享与远程控制的基础接入流程，结合实际开发中常见问题，对横竖屏适配、权限处理及稳定性问题进行了说明。通过这些能力，可以快速搭建远程协助、设备控制、内容共享等典型场景。

围绕屏幕共享与实时互动能力，我们还会持续整理更多细分场景与实现细节，包括但不限于：

• Android 屏幕共享完整实现流程与关键参数配置
• 屏幕共享 + 实时音视频（RTC）组合方案实践
• 远程控制实现机制（输入注入、无障碍能力等）解析
• 常见问题与兼容性适配（黑屏、卡顿、权限异常等）
• 跨端场景（Android / iOS / Web）屏幕共享方案对比

本系列将围绕「RTC SDK 接入与实时互动能力实现」持续更新，适合需要构建屏幕共享、远程协作及实时互动能力的开发者参考。