萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android View 截圖並自訂畫質儲存:Bitmap + Canvas 實作詳解

將任意 View (含 ListView、RecyclerView、自定義繪圖 View) 截圖並儲存為 JPEG/PNG,且可控制輸出畫質,是分享生成圖、長圖拼接、離線快取的常見需求。本文提供完整、可生產環境使用的截圖工具方法。

核心截圖方法

public class ViewScreenshotUtils {

    /**
     * 將 View 繪製到 Bitmap 並儲存為檔案
     * @param view        目標 View (需已完成 layout,寬高 > 0)
     * @param filePath    輸出檔案完整路徑
     * @param format      CompressFormat.JPEG 或 PNG
     * @param quality     JPEG 品質 0-100 (PNG 忽略此參數)
     * @return true 成功,false 失敗
     */
    public static boolean saveViewAsImage(View view, String filePath,
                                          Bitmap.CompressFormat format, int quality) {
        if (view == null || view.getWidth() == 0 || view.getHeight() == 0) {
            Log.e("Screenshot", "View 未佈局完成或尺寸為 0");
            return false;
        }

        // 1. 建立對應尺寸的 Bitmap (ARGB_8888 保留透明通道)
        Bitmap bitmap = Bitmap.createBitmap(view.getWidth(), view.getHeight(), Bitmap.Config.ARGB_8888);
        Canvas canvas = new Canvas(bitmap);

        // 2. 將 View 繪製到 Canvas (包含背景、子 View、滾動位置)
        view.draw(canvas);

        // 3. 儲存檔案
        File file = new File(filePath);
        try {
            File parent = file.getParentFile();
            if (parent != null && !parent.exists()) parent.mkdirs();

            FileOutputStream fos = new FileOutputStream(file);
            bitmap.compress(format, quality, fos);
            fos.flush();
            fos.close();
            return true;
        } catch (IOException e) {
            Log.e("Screenshot", "儲存失敗", e);
            return false;
        } finally {
            if (!bitmap.isRecycled()) bitmap.recycle(); // 及時釋放原生記憶體
        }
    }

    /**
     * 截取可滾動 View (ScrollView, RecyclerView, ListView) 完整內容長圖
     * 原理:暫時關閉滾動、測量完整高度、建立大 Bitmap、手動 dispatchDraw
     */
    public static Bitmap captureScrollView(View scrollView) {
        // 僅示意核心邏輯,完整版需處理滾動位置還原、硬體加速關閉等細節
        // 生產環境建議使用成熟庫:https://github.com/Blankj/AndroidUtilCode/blob/master/lib/utilcode/src/main/java/com/blankj/utilcode/util/ScreenUtils.java
        return null;
    }
}

使用範例

// 在按鈕點擊或分享動作中呼叫
Button btnSave = findViewById(R.id.btn_save);
btnSave.setOnClickListener(v -> {
    View targetView = findViewById(R.id.content_container); // 任意容器 View
    String path = getExternalFilesDir(Environment.DIRECTORY_PICTURES) + "/share_" + System.currentTimeMillis() + ".jpg";
    
    // 背景執行緒執行,避免主執行緒卡頓
    Executors.newSingleThreadExecutor().execute(() -> {
        boolean success = ViewScreenshotUtils.saveViewAsImage(targetView, path, Bitmap.CompressFormat.JPEG, 90);
        runOnUiThread(() -> {
            if (success) {
                Toast.makeText(this, "已儲存至相簿", Toast.LENGTH_SHORT).show();
                // 發送媒體掃描廣播讓相簿立即顯示
                MediaScannerConnection.scanFile(this, new String[]{path}, null, null);
            } else {
                Toast.makeText(this, "截圖失敗", Toast.LENGTH_SHORT).show();
            }
        });
    });
});

關鍵細節與避坑

問題原因解決方案
截圖為空白/黑屏View 開啟硬體加速,Canvas 無法正確繪製view.setLayerType(View.LAYER_TYPE_SOFTWARE, null) 截圖前關閉,截圖後恢復
RecyclerView/ListView 僅截可見區域View 實際寬高僅為螢幕可見範圍使用 captureScrollView 邏輯:測量完整高度、建立大 Bitmap、手動 dispatchDraw
Bitmap OOM長圖過大超過記憶體限制分塊截圖拼接、降低採樣率、使用 inBitmap 重用、或改用 Picture 錄製繪圖指令
儲存無權限Android 10+ 分區儲存限制使用 getExternalFilesDir() (應用專屬目錄,無需權限) 或 MediaStore 插入媒體庫
透明背景變黑JPEG 不支援透明,預設填黑需透明背景請用 PNG;或預先在 Canvas 繪製白色底色

生產環境建議

手寫截圖工具易踩坑,正式專案建議直接引用成熟庫:

  • AndroidUtilCode - ScreenUtils:implementation 'com.blankj:utilcodex:1.30.9',一鍵 ScreenUtils.captureView(view)、ScreenUtils.captureScrollView(recyclerView)。
  • LongShot:專為長圖截圖優化,支援 RecyclerView/ListView/WebView 自動滾動拼接。
copyright © 萬盛學電腦網 all rights reserved