屏幕分享

编辑文档更新于 2025-01-16 07:59:52

BRTC 在 Android 系统上支持屏幕分享，即将当前系统的屏幕内容通过 BRTC SDK 分享给房间里的其他用户。

移动端 BRTC Android 版本屏幕分享并不像桌面端版本一样支持“辅路分享”，因此在启动屏幕分享时，摄像头的采集需要先被停止，否则会相互冲突
当一个 Android 系统上的后台 App 在持续使用 CPU 时，很容易会被系统强行杀掉，而且屏幕分享本身又必然会消耗 CPU。要解决这个看似矛盾的冲突，我们需要在 App 启动屏幕分享的同时，在 Android 系统上弹出悬浮窗。由于 Android 不会强杀包含前台 UI 的 App 进程，因此该种方案可以让您的 App 可以持续进行屏幕分享而不被系统自动回收。如下图所示：

启动屏幕分享

要开启 Android 端的屏幕分享，只需调用 BRTC 中的 startScreenCapture() 接口即可。但如果要达到稳定和清晰的分享效果，您需要关注如下三个问题：

设定视频编码参数

通过设置 startScreenCapture() 中的首个参数 encParams ，您可以指定屏幕分享的编码质量。如果您指定 encParams 为 null，SDK 会自动使用之前设定的编码参数，我们推荐的参数设定如下：

参数项	参数名称	常规推荐值	文字教学场景
分辨率	videoResolution	1280 × 720	1920 × 1080
帧率	videoFps	10 FPS	8 FPS
最高码率	videoBitrate	1600 kbps	2000 kbps
分辨率自适应	enableAdjustRes	NO	NO

由于屏幕分享的内容一般不会剧烈变动，所以设置较高的 FPS 并不经济，推荐10 FPS即可
如果您要分享的屏幕内容包含大量文字，可以适当提高分辨率和码率设置
最高码率（videoBitrate）是指画面在剧烈变化时的最高输出码率，如果屏幕内容变化较少，实际编码码率会比较低

弹出悬浮窗以避免被强杀

从 Android 7.0 系统开始，切入到后台运行的普通 App 进程，但凡有 CPU 活动，都很容易会被系统强杀掉。所以当 App 在切入到后台默默进行屏幕分享时，通过弹出悬浮窗的方案，可以避免被系统强杀掉。同时，在手机屏幕上显示悬浮窗也有利于告知用户当前正在做屏幕分享，避免用户泄漏个人隐私。

方案1：弹出普通的悬浮窗要弹出类似 “Boom 视频会议” 的迷你悬浮窗，您只需要参考示例代码中的实现即可：

public void showView(View view, int width, int height) {
        mWindowManager = (WindowManager) mContext.getSystemService(Context.WINDOW_SERVICE);
        //TYPE_TOAST仅适用于4.4+系统，假如要支持更低版本使用TYPE_SYSTEM_ALERT(需要在manifest中声明权限)
        //7.1（包含）及以上系统对TYPE_TOAST做了限制
        int type = WindowManager.LayoutParams.TYPE_TOAST;
        if (Build.VERSION.SDK_INT > Build.VERSION_CODES.N) {
            type = WindowManager.LayoutParams.TYPE_PHONE;
        }
        mLayoutParams = new WindowManager.LayoutParams(type);
        mLayoutParams.flags = WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE;
        mLayoutParams.flags |= WindowManager.LayoutParams.FLAG_WATCH_OUTSIDE_TOUCH;
        mLayoutParams.width = width;
        mLayoutParams.height = height;
        mLayoutParams.format = PixelFormat.TRANSLUCENT;
        mWindowManager.addView(view, mLayoutParams);
}

方案2：弹出摄像头预览窗由于 BRTC Android 版本屏幕分享并不像桌面端版本一样支持“辅路分享”，因此在启动屏幕分享时，摄像头这一路的视频数据无法上行，否则会相互冲突。那要如何才能做到同时分享屏幕和摄像头画面呢？答案很简单：只需要在屏幕上悬浮一个摄像头画面即可，这样一来在采集屏幕画面的同时也会将摄像头画面一并分享出去。

观看屏幕分享

观看 Android / iOS 屏幕分享若用户通过 Android / iOS 进行屏幕分享，会通过主流进行分享。房间里的其他用户会通过 BRTCListener 中的 onScreenCaptureStarted 事件获得这个通知。希望观看屏幕分享的用户可以通过 startRemoteView 接口来启动渲染远端用户主流画面。

常见问题

目前一个 BRTC 音视频房间只能有一路屏幕分享