前言
做过Android屏幕截图的朋友应该知道在Android5.0之前如果希望截图屏幕,是需要获取系统root权限的。但,在5.0之后Android开放了新的接口android.media.projection,使用该接口,第三方应用程序无需获取系统root权限也可以直接进行屏幕截图操作了。查询其官方api可知,该接口主要用来“屏幕截图”操作和“音频录制”操作,这里只讨论用于屏幕截图的功能。由于使用了媒体的映射技术手段,故截取的屏幕并不是真正的设备屏幕,而是截取的通过映射出来的“虚拟屏幕”。不过,因为截图我们希望的得到的肯定是一张图而已,而“映射”出来的图片与系统屏幕完全一致,所以,对于普通截屏操作,该方法完全可行。
一、使用方法
首先用参数MEDIA_-PROJECTION_SERVICE调 用Context.getSystemService(),得到MediaProjectionManager类别实例;
其次,调用 createScreenCaptureIntent ()得到一个Intent;再次,使用startActivityForResult()启动屏幕捕捉;
最后,将结果返回到 getMediaProjection()上,获取捕捉数据。
二、Demo案例
该demo中使用了service,且该服务需要获取到startActivityForResult中的结果数据,由于直接在service中调用startActivityForResult不现实,故在该demo中还是用了共享类数据模型。由于代码较多,下面只对关键步骤稍作说明。
1、关键步骤及代码
1) 获取MediaProjectionManager类实例:
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
mMediaProjectionManager=MediaProjectionManager)getApplication().getSystemService(Context.MEDIA_PROJECTION_SERVICE);
startIntent();
}
2) 利用MediaProjectionManager类实例的功能函数createScreenCaptureIntent()生成intent,为接下来的的抓取屏幕做准备
startActivityForResult(mMediaProjectionManager.createScreenCaptureIntent(), REQUEST_MEDIA_PROJECTION);
3) 在onActivityResult()中获取resultCode和resultData,以方便下面getMediaProjection()使用。
public void onActivityResult(int requestCode, int resultCode, Intent data) {
......
result = resultCode;
intent = data;
......
}
4) 利用第一步中的MediaProjectionManager类实例,通过getMediaProjection()方法(参数分别为3中的resultCode和resultData)获取当前的屏幕映射,并保存到临时MediaProjection实例中。
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");
}
5) 使用ImageReader实例通过getSurface()方法获取屏幕表层,使用4步中的MediaProjection临时实例通过createVirtualDisplay()方法进行虚拟屏幕的显示。
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");
}
6) 转化并保存截取的屏幕数据到文件(命名、后缀自定义,按照一般的图片格式就可以了,如:png等)
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");
.......
}
2、LOG对比
12-02 15:30:22.390 I/art (19796): Late-enabling -Xcheck:jni
12-02 15:30:22.710 I/View (19796): ssignParent(ViewParent parent) parent is: android.view.ViewRootImpl@1fc4ad78
12-02 15:30:22.900 I/OpenGLRenderer(19796): Initialized EGL, version 1.4
12-02 15:30:24.620 I/MainActivity(19796): user agree the application to capture screen
12-02 15:30:24.770 I/MainActivity(19796): start service Service1
12-02 15:30:24.930 I/View (19796): ssignParent(ViewParent parent) parent is: android.view.ViewRootImpl@25532924
12-02 15:30:24.930 I/Service (19796): created the float sphere view
12-02 15:30:24.940 I/Service (19796): prepared the virtual environment
12-02 15:30:24.980 I/ash ( 4267): view add pid:19796 uid:10161
12-02 15:30:24.980 I/AppsCleanUp( 4267): add top view, pid:19796 count:1
12-02 15:30:25.630 I/View (19796): ssignParent(ViewParent parent) parent is: null
12-02 15:30:25.660 I/View (19796): ssignParent(ViewParent parent) parent is: null
12-02 15:30:30.160 I/Service (19796): start screen capture intent
12-02 15:30:30.160 I/Service (19796): want to build mediaprojection and display virtual
12-02 15:30:30.170 I/Service (19796): mMediaProjection defined
12-02 15:30:30.190 I/Service (19796): virtual displayed
12-02 15:30:31.200 I/Service (19796): image data captured
12-02 15:30:31.200 I/Service (19796): image file created
12-02 15:30:32.020 I/Service (19796): screen image saved
12-02 15:30:40.340 I/PgedBinderListener( 4267): kstate callback type:8 value1=19796 value2=KILLED
12-02 15:30:40.570 I/MediaProcessHandler( 3417): processOp opType: 1, uid: 10161, pid: 19796
12-02 15:30:40.570 W/MediaProcessHandler( 3417): remove target not exist, maybe the UI process: uid: 10161, pid: 19796
12-02 15:30:40.570 I/HwSystemManager( 4203): HoldService:uid:10161 pid:19796 died
12-02 15:30:40.570 I/HwSystemManager( 4203): HoldService:oldVersionKey:10161,19796
3、附件及效果图
【附件】 CaptureScreen.rar
【效果图】
4、操作说明
安装完成并启动该apk后,会弹出一个对话框,点击“立即开始”,整个对话框会直接退出,然后会出现一个火苗洋时代的浮动小球。
需要截屏时,直接单击该小球即可。
默认保存的截图路径在:sdcard/Pictures路径下,
有的手机的图库查看器中设有默认文件夹的选择路径功能,如果在图库查看器中看不到截图,则可以直接通过“文件管理”到“本地/内部存储/Pictures”路径下查看。
三、总结
通过上面实例可以看出,该方法的使用主要工作就在截屏前的准备上。需要说明的是,其中有部分像素微调的代码,该微调操作是为了消除截图的黑边框(毕竟真正截的图是媒体的映射屏~~)。另外,如上文提到,该功能是在Android5.0才开始加入的(或者说开放出来的)新接口,所以,该方法只能用于5.0以上的Android版本(api21以上)。
另外,通过上述说明可以得出,整个阶段分为映射准备阶段和开始截屏并保存阶段。需要注意的是:准备阶段完成后需要等待1s或者更长时间才可以去操作截屏,否则有可能imageReader在进行newInstance时不成功!!(同事在移植该应用时遇到过,在此添加上)