Android 實現類似二維碼掃描框的拍照裁剪功能

需求分析

想要一個自定義相機界面：畫面中央顯示一個半透明遮罩框（類似二維碼掃描框），只有框內區域在按下快門後被保存為圖片。

核心實現步驟

1. 自定義 Camera Preview 界面

• 繼承 SurfaceView 並實現 SurfaceHolder.Callback，用於顯示相機預覽流。
• 在 onDraw(Canvas) 中繪製半透明遮罩與中間透明的「掃描框」。

2. 計算裁剪區域座標

預覽畫面與最終拍照圖片的尺寸、比例通常不同，需將框在 SurfaceView 上的座標映射到圖片像素座標：

// 假設掃描框在 SurfaceView 中的矩形為 rectF
float scaleX = (float)pictureWidth / surfaceViewWidth;
float scaleY = (float)pictureHeight / surfaceViewHeight;
int left   = (int)(rectF.left * scaleX);
int top    = (int)(rectF.top * scaleY);
int right  = (int)(rectF.right * scaleX);
int bottom = (int)(rectF.bottom * scaleY);

3. 拍照回調中裁剪 Bitmap

Camera.PictureCallback jpegCallback = (data, camera) -> {
    Bitmap full = BitmapFactory.decodeByteArray(data, 0, data.length);
    // 根據相機方向旋轉（關鍵！）
    Matrix matrix = new Matrix();
    matrix.postRotate(getDisplayOrientation());
    Bitmap rotated = Bitmap.createBitmap(full, 0, 0, full.getWidth(), full.getHeight(), matrix, true);
    // 裁剪
    Bitmap cropped = Bitmap.createBitmap(rotated, left, top, right-left, bottom-top);
    // 保存 cropped ...
};

關鍵注意點

• 相機方向處理：前置/後置相機、裝置旋轉會導致圖片方向不一致，必須根據 Camera.CameraInfo.orientation 計算正確旋轉角度。
• 權限與生命周期：CAMERA 權限、onPause/release() 釋放相機資源。
• API 選擇：Android 5.0+ 建議使用 Camera2 API；舊版可用 Camera（已棄用但仍可用）。

開源參考項目

• Android-Scanner-View —— 掃描框 UI + 裁剪邏輯
• Google Camera2Basic —— 官方 Camera2 範例

總結

核心在於：自定義預覽 UI 繪製框 → 座標映射 → 拍照回調中旋轉並裁剪 Bitmap。建議直接參考成熟開源庫，避免踩坑。