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 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; }
}
android.hardware.Camera **API 21+ 棄用**,Android 11+ 部分設備已移除實現。CameraManager + CameraDevice + CaptureRequest,底層控制、支援 RAW、手動曝光、多攝像頭協同。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)