Android BitmapFactory.decodeByteArray 參數詳解

在 Android 開發中，BitmapFactory.decodeByteArray 是將字節數組解碼為 Bitmap 圖片的核心方法。理解其各參數含義對於圖片加載、壓縮和內存優化至關重要。

方法簽名

public static Bitmap decodeByteArray(byte[] data, int offset, int length, Options opts)

參數詳細說明

1. byte[] data - 圖片數據源

包含圖片原始字節數據的數組，通常來自網絡下載、文件讀取或資源文件。數組內容必須是有效的圖片格式（如 JPEG、PNG、WebP 等）。

2. int offset - 解碼起始偏移量

指定從數組的哪個位置開始解碼，單位為字節。一般設置為 0，即從數組開頭開始。如果數組包含多張圖片或有文件頭信息，可通過此參數跳過無關數據。

3. int length - 解碼數據長度

指定要解碼的字節數量，一般設置為 data.length（即整個數組長度）。配合 offset 可實現只解碼數組中特定片段的數據。

4. Options opts - 解碼選項配置

用於控制解碼行為的關鍵參數，常用屬性包括：

• inSampleSize：縮放比例（如 2 表示寬高各縮小 1/2，像素減少 3/4），用於加載大圖防止 OOM。
• inJustDecodeBounds：若為 true，僅解析圖片尺寸不分配內存，常用於預計算縮放比例。
• inPreferredConfig：指定 Bitmap 配置（如 ARGB_8888、RGB_565），影響內存佔用和顯示質量。
• inMutable：是否創建可變 Bitmap（API 11+），便於後續像素操作。

實戰建議

加載大圖時，建議先設置 inJustDecodeBounds=true 獲取圖片原始尺寸，計算合適的 inSampleSize 後再重新解碼。這是 Android 官方推薦的高效加載大圖流程。