Android之MediaProjectionManager实现手机截屏总结

比较好的文章：

Android中使用代码截图的各种方法总结

http://blog.csdn.net/woshinia/article/details/11520403

手机截屏：

http://www.cnblogs.com/tgyf/p/4655507.html

转载的地方：

http://www.cnblogs.com/tgyf/p/4851092.html

分享一种截屏方法

在任何时候点击手机上的浮动小球（红色圈内）就能完成整个屏幕信息的截取功能，而且最终保存的图像还不会包含该小球，这就是本文将要介绍的 方法。手机整体屏幕获取项目下载链接：http://files.cnblogs.com/files/tgyf/CaptureScreen.rar。

　　以新的视角实现手机屏幕的截取（快照）功能，文章可能比较长，感兴趣的朋友一定得看完，会有收获的哦！若发现有哪些地方存在问题或某些功能有更好的实现方式，欢迎指点，先谢过（我可以尽快改正或完善，以免继续误导别人）。

　　关于手机（或平板，以下描述均以手机表示这两类设备）整体屏幕的截取，有的机型默认设置的方式是同时按下电源键和一个音量键（如华硕、诺基亚等，向下音量键+电源键），有的机型是同时按下电源键和Home键（如苹果）。另外，借助一些辅助工具经过特定的设置也是可以完成屏幕快照的获取。

　　从打算开发一个与传统截屏方法不同的截屏应用开始，针对Android手机截屏的基本原理、相关知识及Google最新案例，已经在学习与摸索的途中写过两篇文章了，感兴趣的朋友可以通过下面给出的链接去瞧一瞧（这方面知识掌握较好的可以直接忽略）。

　　在Win7+Android Studio环境尝试了网络上晒出的很多方式均失败后，带着受打击的心态写了第一篇文章：

　　“Android手机截屏”——http://www.cnblogs.com/tgyf/p/4655507.html。

　　当时的目的是希望实现过的大神能给点有用的建议或意见。当然，一般来说Android应用在Android Studio和Eclipse下都是可以实现的，虽不能将项目代码在两者之间直接进行转换，但如若工作量不是特别大，移植起来也不麻烦，尝试过的朋友应该懂得。

　　可能对于截屏应用进行学习或者实现的人不太多，笔者并没有得到什么宝贵性的建议。后面不甘心又进行了一番Google，还是没有直截了当的答案，最后决定静下心来老老实实地分析案例源码（案例没有屏幕数据获取与图片保存的实现）。于是就有了第二篇文章：

　　“Google最新截屏案例详解”——http://www.cnblogs.com/tgyf/p/4675082.html。

　　简单回顾一下：如果只是想得到正在运行的应用程序自身的界面，那相当简单，真正获取界面信息的代码只有两三句，在第一篇文章给出的例子中有提及。由于在旧版本的API中，Google是将手机截屏相关的方法与接口隐藏的，开发者要想自主实现手机完整屏幕的快照，有很多局限性（必须采用System级别的应用开发，或者在Linux下进行Root、源码编译等操作），这部分内容的总结在第二篇文章中。

　　大家都知道一些手机厂商会在自家手机发售前定制、预装一些应用，而这些应用APK有些就是System级的（需要通过源码Build）。也就是说不是没有办法利用隐藏的方法或借口实现手机截屏，而是本文将要寻找一种谁都能自己进行实现的方式，包括初学者。

　　俗话说事不过三，今天这篇文章就来说说怎么实现轻松自在地、以一种全新的方式进行手机截屏，希望能给人眼前一亮的感觉。

　　本文截屏应用的实现思路大致是这样：

　　1、抛弃组合快捷键，采用浮动小图标作为截屏按键（类似于360浮动小球，对其思想和详细的实现方式感兴趣的小伙伴可以见另一篇文章：“Android浮动小球与开机自启动”——http://www.cnblogs.com/tgyf/p/4665401.html）。浮动小图标的实现类Service1继承自Service类，这样可以方便地创建只有一个浮动图标按键的布局，在Activity等地方利用startService(Intent intent)方法开启服务。

　　2、由于浮动按键本身不是希望截取的屏幕信息，故在开始截屏后将其隐藏，图像保存后面再使其浮现。

　　3、图像保存为PNG格式，路径为手机sdcard的Pictures文件目录下，而系统截屏默认的目录是Screenshots。

　　4、浮动小球的优先级为一般应用的最顶层，即除了状态栏下拉列表外，小球总是可见的，这要得益于Service类的性质了。虽然在看电视等环境下会比较不适合，但该设计能让用户随时、方便地截取到想要的屏幕图像。

　　5、开机自启动功能虽然保留了，但是因为截屏应用需要得到用户的同意，所以在手机重启后由广播机制自动打开的小球并不能完成截屏，还是需要点击应用图标打开应用以进行截取环境的请求。

　　文章开头已经给出整个工程的代码（Android Studio版本），所以在介绍过程中就只给出实现截屏的关键代码，感兴趣的可以下载并自己进行实践。这里再给出链接为：http://files.cnblogs.com/files/tgyf/CaptureScreen.rar。一切准备就绪，开始吧。

 

一、截屏请求结果数据共享类ShotApplication

　　上面已经提到，屏幕获取需要用户同意，初次运行时会有请求对话框，同意之后才能继续，否则程序会终止。既然需要用户选择后的信息，那在发出截屏请求时就不能用简单的startActivity(Intent intent)方法，而是要用startActivityForResult(Intent intent, intresquestCode)方法。而可恨的是Service类中startActivityForResult(Intent intent, int resquestCode)方法不可用，确切的说是不存在可供子类重载的onActivityResult(int resquestCode, int resultCode, Intent data) 方法。但现实是Service1类在实现截屏过程中又要用到后面两个返回值（resultCode与data）来构建MediaProjection类的对象。

　　可能有人会有疑问，那截屏过程直接在Activity中进行不就可以了吗？没错，是可以。但是问题在于我们需要在任何想截取屏幕的时候就能快速、方便地进行，即需要借助利用Service实现并浮动在一般性应用窗口之上的小球。而在Activity中实现的话就达不到这种效果了，往往能获取的只能是应用本身界面，或者是将其隐藏后的下一层界面，总之做不到想要即可得的效果。

　　所以，首要问题是让类Service1的对象能得到这两个数据。另外得注意，Bundle可以完成一般数据的加载并赋给Intent类对象，然后一起发送给目标类，但参数data本身就是Intent类型的。虽然Intent类存在putExtras(Intent src)方法，但为了体现面向对象数据封装的思想，这里采取的是数据共享的思路，利用继承自Application类的子类ShotApplication，然后定义需要共享的成员变量（有些是其他类的对象）。类代码很简单（不包括import *）：

public class ShotApplication extends Application {
    private int result;
    private Intent intent;
    private MediaProjectionManager mMediaProjectionManager;

    public int getResult(){
        return result;
    }

    public Intent getIntent(){
        return intent;
    }

    public MediaProjectionManager getMediaProjectionManager(){
        return mMediaProjectionManager;
    }

    public void setResult(int result1){
        this.result = result1;
    }

    public void setIntent(Intent intent1){
        this.intent = intent1;
    }

    public void setMediaProjectionManager(MediaProjectionManager mMediaProjectionManager){
        this.mMediaProjectionManager = mMediaProjectionManager;
    }
}

其中MediaProjectionManager类对象在发送截屏请求和构建MediaProjection类对象时均会用到，至于成员值的设置及获取很直观，就不解释了。那么数据的传递就明朗了：先从主程序类MainActivity中存入共享类ShotApplication，然后服务类Service1从共享类ShotApplication中提取出来。

 

二、主程序类MainActivity所做4件事

　　先给出代码（不包括import *），然后分析到底是哪4件事：

public class MainActivity extends ActionBarActivity {
    private int result = 0;
    private Intent intent = null;
    private int REQUEST_MEDIA_PROJECTION = 1;
    private MediaProjectionManager mMediaProjectionManager;

    @TargetApi(Build.VERSION_CODES.LOLLIPOP)
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        mMediaProjectionManager = (MediaProjectionManager)getApplication().getSystemService(Context.MEDIA_PROJECTION_SERVICE);
        startIntent();
    }

    @TargetApi(Build.VERSION_CODES.LOLLIPOP)
    private void startIntent(){
        if(intent != null && result != 0){
            ((ShotApplication)getApplication()).setResult(result);
            ((ShotApplication)getApplication()).setIntent(intent);
            Intent intent = new Intent(getApplicationContext(), Service1.class);
            startService(intent);
        }else{
            startActivityForResult(mMediaProjectionManager.createScreenCaptureIntent(), REQUEST_MEDIA_PROJECTION);
            ((ShotApplication)getApplication()).setMediaProjectionManager(mMediaProjectionManager);
        }
    }

    @TargetApi(Build.VERSION_CODES.LOLLIPOP)
    @Override
    public void onActivityResult(int requestCode, int resultCode, Intent data) {
        if (requestCode == REQUEST_MEDIA_PROJECTION) {
            if (resultCode != Activity.RESULT_OK) {
                return;
            }else if(data != null && resultCode != 0){
                result = resultCode;
                intent = data;
                ((ShotApplication)getApplication()).setResult(resultCode);
                ((ShotApplication)getApplication()).setIntent(data);
                Intent intent = new Intent(getApplicationContext(), Service1.class);
                startService(intent);

                finish();
            }
        }
    }
}

向用户提出截屏请求的代码就是下面这句：

startActivityForResult(mMediaProjectionManager.createScreenCaptureIntent(), REQUEST_MEDIA_PROJECTION);
这正是类MainActivity做的第1件事。当然，在这之前需要获取类MediaProjectionManager实例，代码为：
mMediaProjectionManager = (MediaProjectionManager)getApplication().getSystemService(Context.MEDIA_PROJECTION_SERVICE);
由于onCreate()方法是应用开启后自动调用的（startIntent随即被调用），所以这一行截屏请求代码也会自动执行。如果是应用安装后第一次开启，那么就会弹出截屏权限允许对话框，需要用户授权。如图：

说到这，既可以解释上面提到思路的第5条了，开机自启动后能够开启服务，但不能执行截屏请求操作。原因很简单：一开机就莫名其妙弹出截屏请求对话框不符合用户使用习惯，再者无论是在广播还是服务中调用sratActivityForResult()方法都是不太现实的。
　　类MainActivity做的第2件事就是将用户操作所返回的值和初始获取的类MediaProjectionManager实例写入数据共享类ShotApplication中了，代码如下：
1 //截屏请求对话框用户操作返回数据result和intent
2 ((ShotApplication)getApplication()).setResult(result);
3 ((ShotApplication)getApplication()).setIntent(intent);
4 //类MediaProjectionManager对象mMediaProjectionManager
5 ((ShotApplication)getApplication()).setMediaProjectionManager(mMediaProjectionManager);
类MainActivity做的第3件事就是肯定是开启截屏服务了，代码如下：
 Intent intent = new Intent(getApplicationContext(), Service1.class);
2 startService(intent);
<span style="font-size: 16px;">　注意自定义方法startIntent()时在onCreate()方法被调用，其在不同时期作用不同。如果在此次被调用之前用户已经允许过截屏操作，那么直接开启截屏服务；而如果没有允许过，则向用户请求，即做上述第1件事。</span><p><span style="font-size: 16px;">　　类MainActivity做的第4件事是将自身销毁，之后的控制权就交给服务类Service1的浮动小球（这即是该类整个界面）了。</span></p><pre name="code" class="html">1 finish();
三、服务类Service1完成整体屏幕截取
　　终于到了关键的类Service1了，同样先给出代码（不包括import *）：
public class Service1 extends Service
{
    private LinearLayout mFloatLayout = null;
    private WindowManager.LayoutParams wmParams = null;
    private WindowManager mWindowManager = null;
    private LayoutInflater inflater = null;
    private ImageButton mFloatView = null;

    private static final String TAG = "MainActivity";

    private SimpleDateFormat dateFormat = null;
    private String strDate = null;
    private String pathImage = null;
    private String nameImage = null;

    private MediaProjection mMediaProjection = null;
    private VirtualDisplay mVirtualDisplay = null;

    public static int mResultCode = 0;
    public static Intent mResultData = null;
    public static MediaProjectionManager mMediaProjectionManager1 = null;

    private WindowManager mWindowManager1 = null;
    private int windowWidth = 0;
    private int windowHeight = 0;
    private ImageReader mImageReader = null;
    private DisplayMetrics metrics = null;
    private int mScreenDensity = 0;

    @Override
    public void onCreate()
    {
        // TODO Auto-generated method stub
        super.onCreate();

        createFloatView();

        createVirtualEnvironment();
    }

    @Override
    public IBinder onBind(Intent intent)
    {
        // TODO Auto-generated method stub
        return null;
    }

    private void createFloatView()
    {
        wmParams = new WindowManager.LayoutParams();
        mWindowManager = (WindowManager)getApplication().getSystemService(getApplication().WINDOW_SERVICE);
        wmParams.type = LayoutParams.TYPE_PHONE;
        wmParams.format = PixelFormat.RGBA_8888;
        wmParams.flags = LayoutParams.FLAG_NOT_FOCUSABLE;
        wmParams.gravity = Gravity.LEFT | Gravity.TOP;
        wmParams.x = 0;
        wmParams.y = 0;
        wmParams.width = WindowManager.LayoutParams.WRAP_CONTENT;
        wmParams.height = WindowManager.LayoutParams.WRAP_CONTENT;
        inflater = LayoutInflater.from(getApplication());
        mFloatLayout = (LinearLayout) inflater.inflate(R.layout.float_layout, null);
        mWindowManager.addView(mFloatLayout, wmParams);
        mFloatView = (ImageButton)mFloatLayout.findViewById(R.id.float_id);

        mFloatLayout.measure(View.MeasureSpec.makeMeasureSpec(0,
                View.MeasureSpec.UNSPECIFIED), View.MeasureSpec
                .makeMeasureSpec(0, View.MeasureSpec.UNSPECIFIED));

        mFloatView.setOnTouchListener(new OnTouchListener() {
            @Override
            public boolean onTouch(View v, MotionEvent event) {
                // TODO Auto-generated method stub
                wmParams.x = (int) event.getRawX() - mFloatView.getMeasuredWidth() / 2;
                wmParams.y = (int) event.getRawY() - mFloatView.getMeasuredHeight() / 2 - 25;
                mWindowManager.updateViewLayout(mFloatLayout, wmParams);
                return false;
            }
        });

        mFloatView.setOnClickListener(new OnClickListener() {

            @Override
            public void onClick(View v) {
                // hide the button
                mFloatView.setVisibility(View.INVISIBLE);

                Handler handler1 = new Handler();
                handler1.postDelayed(new Runnable() {
                    public void run() {
                        //start virtual
                        startVirtual();
                    }
                }, 500);

                Handler handler2 = new Handler();
                handler2.postDelayed(new Runnable() {
                    public void run() {
                        //capture the screen
                        startCapture();
                    }
                }, 1500);

                Handler handler3 = new Handler();
                handler3.postDelayed(new Runnable() {
                    public void run() {
                        mFloatView.setVisibility(View.VISIBLE);
                        //stopVirtual();
                    }
                }, 1000);
            }
        });

        Log.i(TAG, "created the float sphere view");
    }

    private void createVirtualEnvironment(){
        dateFormat = new SimpleDateFormat("yyyy_MM_dd_hh_mm_ss");
        strDate = dateFormat.format(new java.util.Date());
        pathImage = Environment.getExternalStorageDirectory().getPath()+"/Pictures/";
        nameImage = pathImage+strDate+".png";
        mMediaProjectionManager1 = (MediaProjectionManager)getApplication().getSystemService(Context.MEDIA_PROJECTION_SERVICE);
        mWindowManager1 = (WindowManager)getApplication().getSystemService(Context.WINDOW_SERVICE);
        windowWidth = mWindowManager1.getDefaultDisplay().getWidth();
        windowHeight = mWindowManager1.getDefaultDisplay().getHeight();
        metrics = new DisplayMetrics();
        mWindowManager1.getDefaultDisplay().getMetrics(metrics);
        mScreenDensity = metrics.densityDpi;
        mImageReader = ImageReader.newInstance(windowWidth, windowHeight, 0x1, 2); //ImageFormat.RGB_565

        Log.i(TAG, "prepared the virtual environment");
    }

    @TargetApi(Build.VERSION_CODES.LOLLIPOP)
    public void startVirtual(){
        if (mMediaProjection != null) {
            Log.i(TAG, "want to display virtual");
            virtualDisplay();
        } else {
            Log.i(TAG, "start screen capture intent");
            Log.i(TAG, "want to build mediaprojection and display virtual");
            setUpMediaProjection();
            virtualDisplay();
        }
    }

    @TargetApi(Build.VERSION_CODES.LOLLIPOP)
    public void setUpMediaProjection(){
        mResultData = ((ShotApplication)getApplication()).getIntent();
        mResultCode = ((ShotApplication)getApplication()).getResult();
        mMediaProjectionManager1 = ((ShotApplication)getApplication()).getMediaProjectionManager();
        mMediaProjection = mMediaProjectionManager1.getMediaProjection(mResultCode, mResultData);
        Log.i(TAG, "mMediaProjection defined");
    }

    @TargetApi(Build.VERSION_CODES.LOLLIPOP)
    private void virtualDisplay(){
        mVirtualDisplay = mMediaProjection.createVirtualDisplay("screen-mirror",
                windowWidth, windowHeight, mScreenDensity, DisplayManager.VIRTUAL_DISPLAY_FLAG_AUTO_MIRROR,
                mImageReader.getSurface(), null, null);
        Log.i(TAG, "virtual displayed");
    }

    @TargetApi(Build.VERSION_CODES.LOLLIPOP)
    private void startCapture(){
        strDate = dateFormat.format(new java.util.Date());
        nameImage = pathImage+strDate+".png";

        Image image = mImageReader.acquireLatestImage();
        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);
        image.close();
        Log.i(TAG, "image data captured");

        if(bitmap != null) {
            try{
                File fileImage = new File(nameImage);
                if(!fileImage.exists()){
                    fileImage.createNewFile();
                    Log.i(TAG, "image file created");
                }
                FileOutputStream out = new FileOutputStream(fileImage);
                if(out != null){
                    bitmap.compress(Bitmap.CompressFormat.PNG, 100, out);
                    out.flush();
                    out.close();
                    Intent media = new Intent(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE);
                    Uri contentUri = Uri.fromFile(fileImage);
                    media.setData(contentUri);
                    this.sendBroadcast(media);
                    Log.i(TAG, "screen image saved");
                }
            }catch(FileNotFoundException e) {
                e.printStackTrace();
            }catch (IOException e){
                e.printStackTrace();
            }
        }
    }

    @TargetApi(Build.VERSION_CODES.LOLLIPOP)
    private void tearDownMediaProjection() {
        if (mMediaProjection != null) {
            mMediaProjection.stop();
            mMediaProjection = null;
        }
        Log.i(TAG,"mMediaProjection undefined");
    }

    private void stopVirtual() {
        if (mVirtualDisplay == null) {
            return;
        }
        mVirtualDisplay.release();
        mVirtualDisplay = null;
        Log.i(TAG,"virtual display stopped");
    }

    @Override
    public void onDestroy()
    {
        // to remove mFloatLayout from windowManager
        super.onDestroy();
        if(mFloatLayout != null)
        {
            mWindowManager.removeView(mFloatLayout);
        }
        tearDownMediaProjection();
        Log.i(TAG, "application destroy");
    }
}
　由于类Service1中大部分代码和之前文章中给出的相差不大，接下来会先将类中各方法简单罗列一遍，然后更加着重介绍改进的地方。
　　从onCreate()方法开始，其调用了两个方法：createFloatView()和createVirtualEnvironment()；createFloatView()方法负责浮动小球的生成、拖动及其点击事件的响应；createVirtualEnvironment()方法定义截屏所需的变量（包括屏幕信息、图像格式、保存格式等等）。另外，各个方法利用Log日志类输出了运行过程中的状态信息，便于观察代码执行过程。
　　关键之处就在于对浮动小球点击事件的响应实现，而拖动只是附带的一个辅助功能而已。浮动小球点击事件的响应代码也完成了4件事情，下面一一进行分析。
　　1、隐藏小球
1 mFloatView.setVisibility(View.INVISIBLE);
　2、初始化截屏环境
public void startVirtual(){
　　if (mMediaProjection != null) {
　　　　Log.i(TAG, "want to display virtual");
　　　　virtualDisplay();
　　} else {
　　　　Log.i(TAG, "start screen capture intent");
　　　　Log.i(TAG, "want to build mediaprojection and display virtual");
　　　　setUpMediaProjection();
　　　　virtualDisplay();
　　}
}
可以看出，这个过程先是对MediaProjection类实例mMediaProjection的值进行了判断，若之前没有初始化（即值为null），则调用setUpMediaProjection()方法获取共享数据并对其进行赋值；若已初始化，则直接调用virtualDisplay()方法利用之前定义的变量对截屏环境进行初始化，而真正执行最终操作的方法为createVirtualDisplay()。
　　3、屏幕截取
      截屏环境初始化完成之后，便可以开始获取屏幕信息了，所以接下来调用的是startCapture()方法。该方法的实现和之前不同，也是容易出错的地方在于以下两句代码：
int rowPadding = rowStride - pixelStride * width;
2 Bitmap bitmap = Bitmap.createBitmap(width+rowPadding/pixelStride, height, Bitmap.Config.ARGB_8888);
值得注意的是调用方法createBitmap()创建Bitmap对象时所用的第1、3个参数，分别对应于图像的宽度、格式。实现过程中发现，只有将格式设置为ARGB_8888才能获取想要的图像质量；而对于宽度，后面会解释为什么要为其设置偏移值。
　　4、显示小球
mFloatView.setVisibility(View.VISIBLE);
四、总结
　　至于服务类Service1类中的其他代码，以及用于开机自启动服务的广播子类BootBroadcastReceiver这里就不打算介绍了。
　　下面来看看不同情况下的效果图，这里指的不同情况跟上述创建位图的两个参数有关。
　　1、图像格式
　　如果创建位图时用的格式不是ARGB_8888，比如RGB_565，虽然屏幕信息的获取没有问题，但是在将信息转化为图像并保存的过程中出现了严重的偏差。如下图：
2、宽度值
　　之前介绍过调用createBitmap()方法设置其宽度参数时添加了偏移信息，如果不这么做，获取的屏幕截图会出现左边部分缺失的情况（右边会以黑色补全）。如下图：
而图像的宽度和格式参数设置正确后的截屏结果图如下：