SetExternalMediaProjection

  • C#

更新时间

设置 SDK 外部的 MediaProjection 采集屏幕视频流。

C#
public abstract int SetExternalMediaProjection(IntPtr mediaProjection);

成功调用该方法后,你设置的外部 MediaProjection 会替换掉 SDK 申请的 MediaProjection 采集屏幕视频流。

当停止屏幕共享或销毁 IRtcEngine 时,SDK 会自动释放 MediaProjection。

适用场景

如果你具备自行申请 MediaProjection 的开发能力,可以直接使用该 MediaProjection 取代 SDK 申请的 MediaProjection。以下列出两种使用场景:

  • 在定制系统的设备上,可避免系统弹窗(即需要用户授予屏幕采集权限),直接开始采集屏幕视频流。
  • 一个屏幕共享进程中存在一个或多个子进程,避免在子进程中自行创建对象的过程出错而导致采集失败。

调用时机

该方法需要在 StartScreenCapture [1/2] 之前调用。

调用限制

在调用该方法前,必须先申请 MediaProjection 权限。

参数

mediaProjection

一个 MediaProjection 对象,用于采集屏幕视频流。

返回值

  • 0: 方法调用成功。
  • < 0: 方法调用失败。 详见 错误码 了解详情和解决建议。

这个页面有帮助吗?