Android MediaProjection学习（一）之和ImageReader实现屏幕截图

最新推荐文章于 2025-06-19 11:57:42 发布

木寸~

最新推荐文章于 2025-06-19 11:57:42 发布

阅读量1.8w

点赞数 7

CC 4.0 BY-SA版权

分类专栏： Android 文章标签： MediaProjection 截图截屏 bitmap

本文链接：https://blog.youkuaiyun.com/qq_35928566/article/details/84858924

Android 专栏收录该内容

77 篇文章

订阅专栏

本文深入探讨MediaProjection在Android中的应用，详细介绍了如何通过MediaProjectionManager获取屏幕内容权限，创建虚拟显示并进行屏幕截图。文章还讲解了关键方法createVirtualDisplay的参数及ImageReader在数据解析中的作用。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

MediaProjection是什么？

按照惯例，附上Google官方文档链接：官方文档

A token granting applications the ability to capture screen contents and/or record system audio. The exact capabilities granted depend on the type of MediaProjection.
A screen capture session can be started through MediaProjectionManager.createScreenCaptureIntent(). This grants the ability to capture screen contents, but not system audio

根据文档介绍。MediaProjection是手环用户获取屏幕内容或者记录系统的界面视频。你需要什么权限取决于MediaProjection的类型。通过MediaProjectionManager.createScreenCaptureIntent()去请求系统的屏幕信息权限，但是不会录制声音。

MediaProjection的重要方法

官方文档里提供了四种方法，但是最重要的就是下面这个方法

返回值	说明
VirtualDisplay	createVirtualDisplay(String name, int width, int height, int dpi, int flags, Surface surface, VirtualDisplay.Callback callback, Handler handler)Creates a VirtualDisplay to capture the contents of the screen.
参数	说明
name	String: The name of the virtual display, must be non-empty.This value must never be null.
-	这个值不能为空，用途还没有搞明白
width	int: The width of the virtual display in pixels. Must be greater than 0.
-	用px表示的确切的值，必须大于0，我们截图的话传进去屏幕宽度就好
height	int: The height of the virtual display in pixels. Must be greater than 0.
-	同上，传入屏幕高度
dpi	int: The density of the virtual display in dpi. Must be greater than 0.
-	传入屏幕的dpi值
flags	int: A combination of virtual display flags. See DisplayManager for the full list of flags.
-	virtual displays的标识组合
surface	Surface: The surface to which the content of the virtual display should be rendered, or null if there is none initially.
-	这个是特别重要的一个参数，是我们的屏幕绘制的内容，会放在这个参数中回调
callback	VirtualDisplay.Callback: Callback to call when the virtual display’s state changes, or null if none.
-	VirtualDisplay.Callback的实例对象作为参数，当展示的状态发生变化时回调
handler	Handler: The Handler on which the callback should be invoked, or null if the callback should be invoked on the calling thread’s main Looper.
-	callback回调时要做的操作放在Handler里

不明白？操作一下

说再多的概念也没有实际写一个Demo来的实在，那就写一个。
开始我们已经了解到要通过MediaProjectionManager.createScreenCaptureIntent()方法获取一个intent来获取权限。

Intent intent = mMediaProjectionManager.createScreenCaptureIntent();
        startActivityForResult(intent, RESULT_CODE);

其中mMediaProjectionManager是MediaProjectionManager的一个实例，RESULT_CODE是一个int的变量，我设置的是1。经过以上操作之后运行app就会有一个弹窗如图所示：
在这里插入图片描述

点击开始就可以获取获取屏幕内容的权限了。我们使用了startActivityForResult方法来启动这个intent，就是为了获取返回值。

protected void onActivityResult(int requestCode, int resultCode, Intent data) {
        super.onActivityResult(requestCode, resultCode, data);
        switch (requestCode) {
            case RESULT_CODE:
                if (resultCode == Activity.RESULT_OK) {
                    mMediaProjection = mMediaProjectionManager.getMediaProjection(resultCode, data);
                    mMediaProjection.createVirtualDisplay("shot_image", windowManager.getDefaultDisplay().getWidth(),
                            windowManager.getDefaultDisplay().getHeight(),
                            displayMetrics.densityDpi, DisplayManager.VIRTUAL_DISPLAY_FLAG_AUTO_MIRROR, imageReader
                                    .getSurface(), null, null);
                }
                break;
        }
    }

这里在onActivityResult方法里用MediaProjectionManager类的getMediaProjection方法传入回传的数据实例化了MediaProjection的对象。
然后重头戏来了，我们调用了createVirtualDisplay方法，上文中已经对这个方法进行了详细的说明，前面几个不再详细说明，我们看看几个关键参数。

1、DisplayManager.VIRTUAL_DISPLAY_FLAG_AUTO_MIRROR

这个参数官方的说明是：Virtual display flag: Allows content to be mirrored on private displays when no content is being shown.大概意思就是屏幕开始展示的时候就会把内容传出来。

2、imageReader.getSurface()

这个参数实际上是通过ImageReader的getSurface()方法来获取一个surface对象。然后把截屏内容传给这个imageReader的实例来处理。

聊聊ImageReader

怎么画风一转开始聊ImageReader呢？其实到上一步，MediaProjection的任务已经完成了。接下来要把数据解析成bitmap然后再使用就好，可以保存到本地或者加载到ImageView控件上，这里我们直接加载到Imageview的控件上。

要转化就一步一步来，这个surface是什么？

A Surface is generally created by or from a consumer of image buffers (such as a SurfaceTexture, MediaRecorder, or Allocation), and is handed to some kind of producer (such as OpenGL, MediaPlayer, or CameraDevice) to draw into.

官方文档里说他就是一个Image的缓冲区，交给一些可以绘制Image的工具去绘制后存在这个缓冲区里。surface我们了解这么多就够了。

接下来看看ImageReader

The ImageReader class allows direct application access to image data rendered into a Surface

这是官方的解释，我们结合代码来看看ImageReader：

private void startCapture() {
        mImageName = System.currentTimeMillis() + ".png";
        Image image = imageReader.acquireLatestImage();
        if (image == null)
            return;
        int width = image.getWidth();
        int height = image.getHeight();
        final Image.Plane[] planes = image.getPlanes();
        final ByteBuffer buffer = planes[0].getBuffer();
        int pixelStride = planes[0].getPixelStride();
        int rowStride = planes[0].getRowStride();
        int rowPadding = rowStride - pixelStride * width;
        Bitmap bitmap = Bitmap.createBitmap(width + rowPadding / pixelStride, height, Bitmap.Config.ARGB_8888);
        bitmap.copyPixelsFromBuffer(buffer);
        bitmap = Bitmap.createBitmap(bitmap, 0, 0, width, height);
        if (bitmap != null)
            iv_screen.setImageBitmap(bitmap);
        image.close();
    }