1. 程式人生 > >Android 截圖(Screenshot)程式碼流程小結

Android 截圖(Screenshot)程式碼流程小結

一、基本介紹

         在Android 4.0 之前,Android手機上如果要使用截圖功能,只能通過Root手機,且使用第3方截圖軟體來實現截圖功能。

         Android4.0中,系統自帶了截圖功能,使用方法是音量下(VOLUME_DOWN)鍵+電源(Power)鍵。

         在同時按下2鍵並保持0.5s左右後,會聽到咔嚓一聲響聲,並彈出如下的一個浮動動畫,顯示截圖效果。


二、程式碼呼叫流程

         以模組來劃分的話,截圖功能的程式碼會依次呼叫Policy,SystemUI,Surface相關的程式碼,具體流程如下流程圖所示


         Policy(PhoneWindowManager.

Java):在此處完成Key的捕獲,當VOLUME_DOWN和Power鍵被幾乎同時按下後,向SystemUI傳送Message開始截圖。

         SystemUI(TakeScreenshotService.java和GlobalScreenshot.java):收到來自Client端的截圖請求後,開始呼叫Surface的API截圖,並將擷取到的圖片通過WindowManager以浮動視窗的形式顯示給使用者檢視。

         Surface(Surface.java和android_view_Surface.cpp):Framework層的Surface.java只是提供一個native方法,實際實現在JNI處的android_view_Surface.cpp中的doScreenshot(...)方法。

三、App端如何使用截圖功能

         以目前程式碼情況看,Surface.java中的screenshot方法是有@hide標記的,即在預設的SDK中是沒有此方法的,暫不支援App端直接使用。

         因為只是@hide標記,如果App要使用,當然也是有方法的,但會和手機ROM有依賴性。我所使用的方法是,在Android原始碼環境下進行編譯,為app賦予system的share uid和platform的簽名,然後就可以在4.0的手機中使用App來截圖了。

         關鍵步驟:

1) 在AndroidManifest.xml中加入android:sharedUserId="android.uid.system"

 屬性

2)在Android.mk中加入platform簽名屬性,並在原始碼環境下編譯。或者將相關jar包引入到Eclipse中做第3方庫引用,並將生成的apk重新打上platform簽名

注:

         在SurfceFlinger.cpp的onTransact方法中,有對截圖的操作進行許可權認證,所以需要為app使用system的shareUserId。

         另:從此處程式碼看,使用android.permission.READ_FRAME_BUFFER的permission應該也可以使用,但測試時通過這種方式未實現,可能哪裡操作不對,也有可能Google還只是預留給後續改進而已。



附錄:App的原始碼檔案:

1. Activity檔案

[java] view plain copy  print?
  1. package com.arvinhe.testscreenshot;  
  2. import android.app.Activity;  
  3. import android.content.Context;  
  4. import android.graphics.Bitmap;  
  5. import android.graphics.Canvas;  
  6. import android.graphics.Matrix;  
  7. import android.os.Bundle;  
  8. import android.util.DisplayMetrics;  
  9. import android.view.Display;  
  10. import android.view.Surface;  
  11. import android.view.View;  
  12. import android.view.WindowManager;  
  13. import android.view.View.OnClickListener;  
  14. import android.widget.Button;  
  15. import android.widget.ImageView;  
  16. publicclass TestScreenShotActivity extends Activity implements OnClickListener{  
  17.     private ImageView img_display;  
  18.     private Button bt_screenshot;  
  19.     private Display mDisplay;  
  20.     private DisplayMetrics mDisplayMetrics;  
  21.     private Matrix mDisplayMatrix;  
  22.     private Bitmap mScreenBitmap;  
  23.     private WindowManager mWindowManager;  
  24.     @Override
  25.     publicvoid onCreate(Bundle savedInstanceState) {  
  26.         super.onCreate(savedInstanceState);  
  27.         setContentView(R.layout.main);  
  28.         bt_screenshot = (Button)findViewById(R.id.bt_screenshot);  
  29.         img_display = (ImageView)findViewById(R.id.img_display);  
  30.         bt_screenshot.setOnClickListener(this);  
  31.         mDisplayMatrix = new Matrix();  
  32.         mWindowManager = (WindowManager) this.getSystemService(Context.WINDOW_SERVICE);  
  33.         mDisplay = mWindowManager.getDefaultDisplay();  
  34.         mDisplayMetrics = new DisplayMetrics();  
  35.         mDisplay.getRealMetrics(mDisplayMetrics);  
  36.     }  
  37.     @Override
  38.     publicvoid onClick(View v) {  
  39.         if(v.equals(bt_screenshot)){  
  40.             mDisplay.getRealMetrics(mDisplayMetrics);  
  41.             float[] dims = {mDisplayMetrics.widthPixels, mDisplayMetrics.heightPixels};  
  42.             float degrees = getDegreesForRotation(mDisplay.getRotation());  
  43.             boolean requiresRotation = (degrees > 0);  
  44.             if (requiresRotation) {  
  45.                 // Get the dimensions of the device in its native orientation
  46.                 mDisplayMatrix.reset();  
  47.                 mDisplayMatrix.preRotate(-degrees);  
  48.                 mDisplayMatrix.mapPoints(dims);  
  49.                 dims[0] = Math.abs(dims[0]);  
  50.                 dims[1] = Math.abs(dims[1]);  
  51.             }  
  52.             mScreenBitmap = Surface.screenshot((int) dims[0], (int) dims[1]);  
  53.             if (requiresRotation) {  
  54.                 // Rotate the screenshot to the current orientation
  55.                 Bitmap ss = Bitmap.createBitmap(mDisplayMetrics.widthPixels,  
  56.                         mDisplayMetrics.heightPixels, Bitmap.Config.ARGB_8888);  
  57.                 Canvas c = new Canvas(ss);  
  58.                 c.translate(ss.getWidth() / 2, ss.getHeight() / 2);  
  59.                 c.rotate(degrees);  
  60.                 c.translate(-dims[0] / 2, -dims[1] / 2);  
  61.                 c.drawBitmap(mScreenBitmap, 00null);  
  62.                 c.setBitmap(null);  
  63.                 mScreenBitmap = ss;  
  64.             }  
  65.             // If we couldn't take the screenshot, notify the user
  66.             if (mScreenBitmap == null) {  
  67.                 return;  
  68.             }  
  69.             // Optimizations
  70.             mScreenBitmap.setHasAlpha(false);  
  71.             mScreenBitmap.prepareToDraw();  
  72.             img_display.setImageBitmap(mScreenBitmap);  
  73.         }  
  74.     }  
  75.     /** 
  76.      * @return the current display rotation in degrees 
  77.      */
  78.     privatefloat getDegreesForRotation(int value) {  
  79.         switch (value) {  
  80.         case Surface.ROTATION_90:  
  81.             return 360f - 90f;  
  82.         case Surface.ROTATION_180:  
  83.             return 360f - 180f;  
  84.         case Surface.ROTATION_270:  
  85.             return 360f - 270f;  
  86.         }  
  87.         return 0f;  
  88.     }  
  89. }  

2. AndroidManifest.xml檔案

[html] view plain copy  print?
  1. <?xmlversion="1.0"encoding="utf-8"?>
  2. <manifestxmlns:android="http://schemas.android.com/apk/res/android"
  3.     package="com.arvinhe.testscreenshot"
  4.     android:versionCode="1"
  5.     android:versionName="1.0"
  6.     android:sharedUserId="android.uid.system">
  7.     <uses-sdkandroid:minSdkVersion="15"/>
  8.     <application
  9.         android:icon="@drawable/ic_launcher"
  10.         android:label="@string/app_name">
  11.         <activity
  12.             android:name=".TestScreenShotActivity"
  13.             android:label="@string/app_name">
  14.             <intent-filter>
  15.                 <actionandroid:name="android.intent.action.MAIN"/>
  16.                 <categoryandroid:name="android.intent.category.LAUNCHER"/>
  17.             </intent-filter>
  18.         </activity>
  19.     </application>
  20. </manifest>

3. Layout檔案

[html] view plain copy  print?
  1. <?xmlversion=