萬盛學電腦網

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

Android 相機 setParameters failed 錯誤解決:預覽尺寸自動匹配最佳支援尺寸

錯誤原因

Camera.Parameters.setPreviewSize(w, h) 拋出 RuntimeException: setParameters failed,**主因:傳入的寬高不在設備支援的預覽尺寸列表中**。不同設備支援尺寸差異極大,不可硬編碼。

正確做法:從支援列表中選擇最接近目標尺寸

Camera.Parameters params = camera.getParameters();
List supportedSizes = params.getSupportedPreviewSizes();

int targetWidth = 640;
int targetHeight = 480;
Camera.Size optimalSize = null;

// 策略:尋找「寬高均 ≥ 目標」且「面積最小」的尺寸 (避免過大浪費記憶體/頻寬)
int minAreaDiff = Integer.MAX_VALUE;
for (Camera.Size size : supportedSizes) {
    if (size.width >= targetWidth && size.height >= targetHeight) {
        int area = size.width * size.height;
        int targetArea = targetWidth * targetHeight;
        int diff = area - targetArea;
        if (diff >= 0 && diff < minAreaDiff) {
            minAreaDiff = diff;
            optimalSize = size;
        }
    }
}

// 兜底:若無尺寸滿足 ≥ 目標,取列表中第一個 (通常是最大或默認)
if (optimalSize == null && !supportedSizes.isEmpty()) {
    optimalSize = supportedSizes.get(0);
    Log.w("Camera", "未找到 ≥ 目標尺寸,使用默認: " + optimalSize.width + "x" + optimalSize.height);
}

if (optimalSize != null) {
    params.setPreviewSize(optimalSize.width, optimalSize.height);
    camera.setParameters(params); // 這裡不再拋出 setParameters failed
} else {
    Log.e("Camera", "設備無支援預覽尺寸!");
}

進階優化:綜合考量長寬比、幀率、效能

/** 選擇最佳預覽尺寸
 * @param targetRatio 目標長寬比 (如 4:3 = 1.333f, 16:9 = 1.777f)
 * @param minWidth 最小寬度
 * @param maxArea 最大面積 (限制記憶體/頻寬)
 */
Camera.Size chooseOptimalPreviewSize(List sizes, float targetRatio, int minWidth, int maxArea) {
    Camera.Size best = null;
    float minRatioDiff = Float.MAX_VALUE;
    int minAreaDiff = Integer.MAX_VALUE;

    for (Camera.Size size : sizes) {
        // 1. 面積限制
        int area = size.width * size.height;
        if (area > maxArea) continue;
        if (size.width < minWidth) continue;

        // 2. 長寬比匹配度
        float ratio = (float) size.width / size.height;
        float ratioDiff = Math.abs(ratio - targetRatio);

        // 3. 綜合評分:優先長寬比接近,其次面積接近目標
        if (ratioDiff < minRatioDiff ||
            (Math.abs(ratioDiff - minRatioDiff) < 0.01f && Math.abs(area - maxArea) < minAreaDiff)) {
            minRatioDiff = ratioDiff;
            minAreaDiff = Math.abs(area - maxArea);
            best = size;
        }
    }
    return best != null ? best : sizes.get(0); // 兜底
}

完整相機開啟流程 (舊 Camera API)

Camera camera = null;
try {
    camera = Camera.open(cameraId); // 0=後置, 1=前置
    Camera.Parameters params = camera.getParameters();

    // 1. 設定預覽尺寸
    Camera.Size previewSize = chooseOptimalPreviewSize(
            params.getSupportedPreviewSizes(), 4f/3f, 640, 1280*720);
    params.setPreviewSize(previewSize.width, previewSize.height);

    // 2. 設定照片尺寸 (獨立於預覽)
    Camera.Size pictureSize = chooseOptimalPreviewSize(
            params.getSupportedPictureSizes(), 4f/3f, 1920, 4000*3000);
    params.setPictureSize(pictureSize.width, pictureSize.height);

    // 3. 其他常用參數
    params.setFocusMode(Camera.Parameters.FOCUS_MODE_CONTINUOUS_PICTURE); // 持續對焦
    params.setFlashMode(Camera.Parameters.FLASH_MODE_AUTO);
    params.setRotation(90); // 根據感應器方向設置 (需結合 OrientationEventListener)

    camera.setParameters(params);

    // 4. 設定預覽顯示 (SurfaceHolder)
    camera.setPreviewDisplay(surfaceHolder);
    camera.startPreview();

} catch (Exception e) {
    Log.e("Camera", "開啟失敗", e);
    if (camera != null) { camera.release(); camera = null; }
}

重要提醒:棄用 Camera API,遷移至 Camera2 / CameraX

  • android.hardware.Camera **API 21+ 棄用**,Android 11+ 部分設備已移除實現。
  • Camera2 API:CameraManager + CameraDevice + CaptureRequest,底層控制、支援 RAW、手動曝光、多攝像頭協同。
  • CameraX (Jetpack):強烈推薦,統一 API 處理碎片化、生命週期感知、自動處理旋轉/縮放/預覽尺寸選擇、支援 Extensions (HDR、夜景、人像虛化)。

CameraX 預覽配置範例 (一行搞定尺寸選擇)

val preview = Preview.Builder()
    .setTargetAspectRatio(AspectRatio.RATIO_4_3)
    .setTargetResolution(Size(640, 480)) // 僅作為建議,內部自動選擇最佳支援尺寸
    .build()
    .also { it.setSurfaceProvider(viewFinder.surfaceProvider) }

cameraProvider.bindToLifecycle(this, cameraSelector, preview, imageCapture, imageAnalysis)
copyright © 萬盛學電腦網 all rights reserved