当前位置：首页 > news >正文

Android使用MediaProjectionManager获取游戏画面和投屏

news 2025/8/2 13:50:19

MediaProjectionManager 是 Android 系统中实现屏幕录制和截屏功能的管理器，允许应用请求用户授权并获取屏幕投影，进而实现屏幕内容的录制或截图。

使用步骤

获取 MediaProjectionManager 实例：

通过 getSystemService(Context.MEDIA_PROJECTION_SERVICE) 获取。

请求权限：

使用 createScreenCaptureIntent() 创建用于请求屏幕捕获权限的 Intent，并通过 startActivityForResult() 启动该 Intent 。此时系统会显示请求授权的弹窗。

处理授权结果：

在 onActivityResult() 中，判断弹窗成功授权后启动服务。若结果码为 RESULT_OK，则通过 getMediaProjection(resultCode, data) 获取 MediaProjection 对象。

创建 VirtualDisplay：

使用 MediaProjection.createVirtualDisplay() 创建虚拟显示，传入屏幕宽度、高度、密度等参数，并指定一个 Surface（如 ImageReader 或 SurfaceView 的 Surface）以捕获屏幕内容。

createVirtualDisplay 说明

参数详解

参数名	含义说明
`name`	虚拟显示的名称，不能为空字符串。
`width`	虚拟屏幕的宽度（像素），必须 > 0。
`height`	虚拟屏幕的高度（像素），必须 > 0。
`densityDpi`	屏幕密度（dpi），建议与真实屏幕一致，可通过 `DisplayMetrics` 获取。
`flags`	控制虚拟显示行为的标志位，如 `VIRTUAL_DISPLAY_FLAG_AUTO_MIRROR` 等。
`surface`	渲染目标，通常是 `ImageReader`、`MediaRecorder` 或 `MediaCodec` 的 `Surface`。
`callback`	监听虚拟显示状态变化的回调，可为 `null`。
`handler`	指定回调线程的 `Handler`，可为 `null`（默认主线程）。

常用 Flags

Flag 名称	含义说明
`VIRTUAL_DISPLAY_FLAG_PUBLIC`	公共显示，允许其他应用在此显示上打开窗口。默认是私有的。
`VIRTUAL_DISPLAY_FLAG_PRESENTATION`	设置为演示显示，常用于双屏展示场景。
`VIRTUAL_DISPLAY_FLAG_SECURE`	安全显示，防止内容被截屏/录制（需系统权限）。
`VIRTUAL_DISPLAY_FLAG_OWN_CONTENT_ONLY`	仅显示自己的内容，不镜像其他屏幕内容。
`VIRTUAL_DISPLAY_FLAG_AUTO_MIRROR`	自动镜像主屏幕内容（常用于录屏）。需要 `MediaProjection` 权限支持。

示例代码：

val mediaProjectionManager = getSystemService(MediaProjectionManager::class.java)
val startMediaProjection = registerForActivityResult(StartActivityForResult()) { result ->if (result.resultCode == RESULT_OK) {val mediaProjection = mediaProjectionManager.getMediaProjection(result.resultCode, result.data!!)val displayMetrics = resources.displayMetricsval surface = mediaRecorder.surface // 也可以是 ImageReader.getSurface()val virtualDisplay = mediaProjection.createVirtualDisplay("ScreenCapture",displayMetrics.widthPixels,displayMetrics.heightPixels,displayMetrics.densityDpi,DisplayManager.VIRTUAL_DISPLAY_FLAG_AUTO_MIRROR,surface,null,null)}
}
startMediaProjection.launch(mediaProjectionManager.createScreenCaptureIntent())

如需进一步处理画面（如截图或编码），可将 Surface 替换为 ImageReader 或 MediaCodec 的输入 Surface，灵活适配不同使用场景。