音视频通话

屏幕共享源获取和应用

功能介绍

Android 端屏幕共享通过系统 MediaProjection API 采集屏幕内容。SDK 封装了权限申请与前台服务,应用调用 startScreenShare 即可开始共享整个屏幕。

此外,SDK 还支持自定义抓屏:由应用自行采集 View 或 Bitmap 图像并送入 SDK。

1. 系统屏幕采集(默认方式)

Android 端默认共享整个屏幕,无需像桌面端那样选择 monitorID 或窗口 ID。调用 startScreenShare 前需:

  1. 在 AndroidManifest.xml 中声明权限与组件(详见 屏幕共享启停);
  2. 配置共享质量参数(详见 屏幕共享质量配置);
  3. 调用 startScreenShare 并处理前台服务通知。

2. 自定义抓屏

若需共享特定 View 的内容(而非整个屏幕),可使用自定义抓屏模式:

// 开启自定义抓屏
RTCMeeting.getInstance().setCustomizeCatchScreen(true);

// 按帧率周期送入 View 图像
RTCMeeting.getInstance().setCustomizeScreenImg(targetView);

// 或送入 Bitmap 图像
RTCMeeting.getInstance().setCustomizeScreenImg(bitmap);

关闭自定义抓屏:

RTCMeeting.getInstance().setCustomizeCatchScreen(false);

相关 API 请参考:

3. 注意事项

  • 自定义抓屏模式下,应用需按配置的帧率周期性调用 setCustomizeScreenImg 送入图像。
  • 共享端不应在共享区域上显示共享内容本身,避免画面无限嵌套。