Android 获取当前Activity的屏幕截图

发表于 | 分类于 ， | 阅读次数

1. 概述

　　该方法是通过View的方式获取当前activity的屏幕截图，并不是frameBuffer的方式，所以有一定的局限性。但是这种方法相对简单，容易理解。

2. 使用方法

  1. 对activity进行截图 
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    /**
         * Activity screenCap
         *
         * @param activity
         * @return
         */
        public static Bitmap activityShot(Activity activity) {
            /*获取windows中最顶层的view*/
            View view = activity.getWindow().getDecorView();
            //允许当前窗口保存缓存信息
            view.setDrawingCacheEnabled(true);
            view.buildDrawingCache();
            //获取状态栏高度
            Rect rect = new Rect();
            view.getWindowVisibleDisplayFrame(rect);
            int statusBarHeight = rect.top;
            WindowManager windowManager = activity.getWindowManager();
            //获取屏幕宽和高
            DisplayMetrics outMetrics = new DisplayMetrics();
            windowManager.getDefaultDisplay().getMetrics(outMetrics);
            int width = outMetrics.widthPixels;
            int height = outMetrics.heightPixels;
            //去掉状态栏
            Bitmap bitmap = Bitmap.createBitmap(view.getDrawingCache(), 0, statusBarHeight, width,
                    height-statusBarHeight);
            //销毁缓存信息
            view.destroyDrawingCache();
            view.setDrawingCacheEnabled(false);
            return bitmap;
        }

  1. 可以将得到的bitmap格式图片保存到本地，也可以用于其他用途。下面是将bitmap保存到本地的方法。

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49
    50
    51
    52
    53
    54
    55
    56
    57
    58
    59
    60
    61
    62
    63
    64
    65
    private static final String SCREENSHOTS_DIR_NAME = "screenShots";
        private static final String SCREENSHOT_FILE_NAME_TEMPLATE = "Screenshot%s.jpg";
        private static final String SCREENSHOT_FILE_PATH_TEMPLATE = "%s/%s/%s";    
    /**
         * 存储到sdcard
         *
         * @param bmp
         * @return
         */
        public static String saveToSD(Bitmap bmp) {
            //判断sd卡是否存在
            if (Environment.getExternalStorageState().equals(Environment.MEDIA_MOUNTED)) {
                //文件名
                long systemTime = System.currentTimeMillis();
                String imageDate = new SimpleDateFormat("yyyy-MM-dd-HH-mm-ss").format(new Date(systemTime));
                String mFileName = String.format(SCREENSHOT_FILE_NAME_TEMPLATE, imageDate);
                File dir = new File(SCREENSHOTS_DIR_NAME);
                //判断文件是否存在，不存在则创建
                if (!dir.exists()) {
                    dir.mkdirs();
                }
                //文件全名
                String mstrRootPath = Environment.getExternalStorageDirectory().toString();
                String mFilePath = String.format(SCREENSHOT_FILE_PATH_TEMPLATE, mstrRootPath,
                        SCREENSHOTS_DIR_NAME, mFileName);
                Log.i(TAG, "file path:" + mFilePath);
                File file = new File(mFilePath);
                if (!file.exists()) {
                    try {
                        file.createNewFile();
                    } catch (IOException e) {
                        e.printStackTrace();
                    }
                }
                Log.i(TAG, "file path:" + file.getAbsolutePath());
                FileOutputStream fos = null;
                try {
                    fos = new FileOutputStream(file);
                    if (fos != null) {
                        //第一参数是图片格式，第二参数是图片质量，第三参数是输出流
                        bmp.compress(Bitmap.CompressFormat.PNG, 100, fos);
                        fos.flush();
                    }
                } catch (FileNotFoundException e) {
                    e.printStackTrace();
                } catch (IOException e) {
                    e.printStackTrace();
                } finally {
                    if (fos != null) {
                        try {
                            fos.close();
                        } catch (IOException e) {
                            e.printStackTrace();
                        }
                    }
                }
                return mFilePath;
            }
            return null;
        }

  2. 注意在AndroidManifest.xml中注册写入的权限

    1
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

3. 截图时遇到的坑

　　在程序中使用上面的方法进行应用内截图，结果出现了下面的错误提示：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
java.lang.IllegalArgumentException: x + width must be <= bitmap.width()
	at android.graphics.Bitmap.createBitmap(Bitmap.java:686)
	at android.graphics.Bitmap.createBitmap(Bitmap.java:654)
	java.lang.IllegalArgumentException: x + width must be <= bitmap.width()
	at android.graphics.Bitmap.createBitmap(Bitmap.java:686)
	at android.graphics.Bitmap.createBitmap(Bitmap.java:654)
	at com.csmijo.practice.utils.ScreenCap.activityShot(ScreenCap.java:85)
	at android.os.Handler.handleCallback(Handler.java:808)
	at android.os.Handler.dispatchMessage(Handler.java:103)
	at android.os.Looper.loop(Looper.java:193)
	at android.app.ActivityThread.main(ActivityThread.java:5532)
	at java.lang.reflect.Method.invokeNative(Native Method)
	at java.lang.reflect.Method.invoke(Method.java:515)
	at com.android.internal.os.ZygoteInit$MethodAndArgsCaller.run(ZygoteInit.java:891)
	at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:707)
	at de.robv.android.xposed.XposedBridge.main(XposedBridge.java:132)
	at dalvik.system.NativeStart.main(Native Method)

　　马上要提交了出现这种坑，内心马上凌乱了。Google后发现，这个错误是由于使用这个方法造成的：

1
Bitmap bitmap = Bitmap.createBitmap(view.getDrawingCache(), 0, statusBarHeight, width,height-statusBarHeight);

这是Bitmap.createBitmap(Bitmap source, int x, int y, int width, int height)方法的介绍：

1
2
3
Returns an immutable bitmap from the specified **subset of the source
bitmap**. The new bitmap may be the same object as source, or a copy
may have been made. It is initialized with the same density as the original bitmap.

该方法返回的是source的子集，所以就要求：

  • x + width <= source.width
  • y + height <= source.height

由于我的程序中是直接使用的屏幕宽度，所以出现了上面的错误。说道屏幕宽度，就引出了我下面的资料查找。

4. Android 获取获取屏幕高度、标题高度、状态栏高度

状态栏标题栏高度测量

该图片出自Android完美获取状态栏高度、标题栏高度、编辑区域高度的获取

  • 最大的草绿色区域是屏幕区域
  • 次大的红色区域是应用界面区域
  • 最小的紫色区域是View绘制区域
  • 屏幕顶端和应用界面顶端之间的部分为状态栏
  • 应用界面顶端与view绘制区域顶端之间的部分为标题栏

1. 下面介绍一些获取屏幕参数的方法

1.View 获取屏幕参数值的方法：

方法 影响区域 说明
onSizeChanged(int w,int h,int oldw,int oldh) view绘制区域 当前view屏幕宽高发生变化时调用，传递view的宽高，其中高度不包括标题高度
getWidth() view绘制区域 返回view的宽度
getHeight() view绘制区域 返回view的高度，不包括标题在内
getWindowVisibleDisplayFrame(Rect outRect) 应用界面区域 返回宽度和View的宽度相等，高度=view的高度 + 标题的高度
getDrawingRect(Rect outRect) view绘制区域 返回绘制区域的区域值，宽度和高度都和view的相等

2.Canvas对象获取画布宽高，由view的draw函数传递canvas对象，也是在view中创建

方法 影响区域 说明
canvas.getWidth() 屏幕区域 返回画布的宽度，即屏幕的宽度
canvas.getHeight() 屏幕区域 返回画布的高度，即屏幕的高度

3.Display对象获取屏幕宽高

通过Activity的getWindowManager.getDefaultDisplay()方法可以获取到display对象

方法 影响区域 说明
display.getWidth() 屏幕区域 返回界面的宽度，即屏幕的宽度
display.getHeight() 屏幕区域 返回界面的高度，即屏幕的高度

2. 状态栏高度的测量

1.方法一：通过系统尺寸资源获取

　　状态栏高度定义在Android系统尺寸资源中status_bar_height，但这并不是公开可直接使用的，例如像通常使用系统资源那样android.R.dimen.status_bar_height。但是系统给我们提供了一个Resource类，通过这个类可以获取资源文件，借此可以获取到status_bar_height：

1
2
3
4
5
6
7
8
9
10
11
12
public static int getStatusBarHeight(Context context) {
		int statusBarHeight = -1;
		/* 获取status_bar_height的资源ID*/
		int resourceId = context.getResources().getIdentifier(
				"status_bar_height", "dimen", "android");
		if (resourceId > 0) {
			// 根据资源ID获取响应的尺寸值
			statusBarHeight = context.getResources().getDimensionPixelSize(
					resourceId);
		}
		return statusBarHeight;
	}

2.方法二：通过R类的反射

1
2
3
4
5
6
7
8
9
10
11
12
13
public static int getStatusBarHeight(Context context) {
		int statusBarHeight = -1;  
        try {  
            Class<?> clazz = Class.forName("com.android.internal.R$dimen");  
            Object object = clazz.newInstance();  
            int height = Integer.parseInt(clazz.getField("status_bar_height")  
                    .get(object).toString());  
            statusBarHeight = getResources().getDimensionPixelSize(height);  
        } catch (Exception e) {  
            e.printStackTrace();  
        }  
		return statusBarHeight;
	}

3.方法三：利用应用区域Top属性

1
2
3
4
5
6
7
8
9
10
public static int getStatusBarHeight(Context context) {
        /*获取windows中最顶层的view*/
        View view = activity.getWindow().getDecorView();
  
        //获取状态栏高度
        Rect rect = new Rect();
        view.getWindowVisibleDisplayFrame(rect);
        int statusBarHeight = rect.top;
		return statusBarHeight;
	}

注意：

　　如果单单获取statusBar高度而不获取titleBar高度时，这种方法并不推荐大家使用，因为这种方法依赖于WMS（窗口管理服务的回调）。正是因为窗口回调机制，所以在Activity初始化时执行此方法得到的高度是0。这个方法推荐在回调方法onWindowFocusChanged()中执行，才能得到预期结果。

3. 标题栏高度的测量

　　正如上面介绍的，应用界面顶端与view绘制区域顶端之间的部分为标题栏。所以自然会想到两种测量标题栏高度的方法：一个是使用Top-Top，另一个就是使用高度-高度。先介绍一下获取各区域宽高的代码：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
//屏幕区域
DisplayMetrics outMetrics = new DisplayMetrics();
WindowManager windowManager = activity.getWindowManager();
windowManager.getDefaultDisplay().getMetrics(outMetrics);
int width = outMetrics.widthPixels;    //屏幕宽度
int height = outMetrics.heightPixels;    //屏幕高度
   
//应用界面区域
View view = activity.getWindow().getDecorView();
Rect rect = new Rect();
view.getWindowVisibleDisplayFrame(rect); 
int appTop = rect.top;    //状态栏高度，也是应用界面顶部的高度值
int appHeight = rect.height();    //应用界面高度
//view绘制区域
Rect outRect2 = new Rect();  
activity.getWindow().findViewById(Window.ID_ANDROID_CONTENT).getDrawingRect(outRect2);   
int viewTop = getWindow().findViewById(Window.ID_ANDROID_CONTENT).getTop();  //view绘制区域顶部的高度值
int viewHeight = outRect2.height();   //view绘制界面的高度

1. 方法一：Top-Top

1
2
3
4
/**
 * 标题栏高度 = view绘制区域顶端高度值 - 应用界面区域顶端高度值 
 */
 int titleHeight = viewTop - appTop;

2. 方法二：高度- 高度

1
2
3
4
/**
 * 标题栏高度 = 应用界面区域高度 - view绘制区域高度
 */
 int titleHeight =  appHeight - viewHeight;

4. 注意事项

  1. 不管你是否设置全屏模式，或是不显示标题栏，在使用获取状态栏高度方法1和获取状态栏高度方法2都会测量到状态栏的高度，理解原理就不难解释——系统资源属性是固定的、真实的，不管你是否隐瞒（隐藏或者显示），它都在那里；

  2. 是若使用获取状态栏高度方法3，以及获取标题栏高度方法1和获取标题栏高度方法2，都是依赖于WMS，是在界面构建后根据View获取的，所以显示了就有高度，不显示自然没高度了。

[参考文献]