android camera参数

Android 相机参数的获取和设置主要通过 Camera API（旧版）和 Camera2 API（新版，强烈推荐）来完成，下面我将围绕这两个 API，并结合具体参数进行讲解。

核心概念：参数的层次结构

在深入具体参数之前,你需要理解 Android 相机参数的组织方式，它通常是一个分层的结构：

1. 设备：代表物理相机硬件（如后置主摄、前置广角、后置长焦等）。
2. 会话：CameraCaptureSession，管理与相机的连接，用于发送请求和接收结果。
3. 请求：CaptureRequest，这是最重要的部分，它包含了“在某一时刻，你希望相机做什么”的所有参数，对焦模式、曝光模式、拍照还是录像、是否开启闪光灯等。
4. 配置：CameraCharacteristics，代表相机硬件的“静态能力”，这些是相机本身固有的属性，你不能改变它们，只能查询，支持哪些分辨率、支持哪些对焦模式、传感器尺寸是多少等。

简单比喻：

• CameraCharacteristics 就像一辆汽车的《说明书》，告诉你这辆车有哪些功能（比如最高时速、有几个档位、有没有ESP）。
• CaptureRequest 就像你踩下油门、转动方向盘、挂上档位的动作，你告诉车在当前状态下要怎么做。
• CameraCaptureSession 就像你和汽车之间的通信协议，确保你的动作被正确执行。

核心参数详解

我们将参数分为两大类：静态能力 和 动态请求。

A. 静态能力 - CameraCharacteristics

这些参数通过 CameraCharacteristics.get(key) 获取，用于了解相机的能力。

B. 动态请求 - CaptureRequest

这些参数设置在 CaptureRequest.Builder 中，用于控制相机在某一帧的行为。

代码示例 (Camera2 API)

下面是一个使用 Camera2 API 设置核心参数的简化示例。

获取静态能力

// 在相机打开后，获取 CameraCharacteristics
CameraManager manager = (CameraManager) getSystemService(Context.CAMERA_SERVICE);
String cameraId = manager.getCameraIdList()[0]; // 假设使用后置摄像头
CameraCharacteristics characteristics = manager.getCameraCharacteristics(cameraId);
// 查询支持的对焦模式
int[] afModes = characteristics.get(CameraCharacteristics.CONTROL_AF_AVAILABLE_MODES);
if (Arrays.asList(afModes).contains(CameraCharacteristics.CONTROL_AF_MODE_CONTINUOUS_PICTURE)) {
    // 支持连续对焦模式，适合拍照
}
// 查询支持的预览尺寸
StreamConfigurationMap map = characteristics.get(CameraCharacteristics.SCALER_AVAILABLE_STREAM_CONFIGURATIONS);
Size[] previewSizes = map.getOutputSizes(SurfaceTexture.class);
// 从 previewSizes 中选择一个合适的尺寸...

创建动态请求

// 创建 CaptureRequest.Builder
// 第一个参数是目标 Surface，第二个参数是模板类型（预览、拍照等）
CaptureRequest.Builder previewRequestBuilder =
        cameraDevice.createCaptureRequest(CameraDevice.TEMPLATE_PREVIEW);
// 1. 设置目标 Surface (预览画面将显示在这个 Surface 上)
previewRequestBuilder.addTarget(surface);
// 2. 设置对焦模式
previewRequestBuilder.set(CaptureRequest.CONTROL_AF_MODE,
        CaptureRequest.CONTROL_AF_MODE_CONTINUOUS_PICTURE);
// 3. 设置曝光模式 (自动闪光)
previewRequestBuilder.set(CaptureRequest.CONTROL_AE_MODE,
        CaptureRequest.CONTROL_AE_MODE_ON_AUTO_FLASH);
// 4. 设置白平衡模式
previewRequestBuilder.set(CaptureRequest.CONTROL_AWB_MODE,
        CaptureRequest.CONTROL_AWB_MODE_AUTO);
// 5. 如果需要锁定对焦或曝光
// previewRequestBuilder.set(CaptureRequest.CONTROL_AF_TRIGGER, CaptureRequest.CONTROL_AF_TRIGGER_START);
// previewRequestBuilder.set(CaptureRequest.CONTROL_AE_LOCK, true);
// 6. 构建最终的 CaptureRequest
CaptureRequest previewRequest = previewRequestBuilder.build();
// 7. 将请求发送到 CameraCaptureSession
cameraCaptureSession.setRepeatingRequest(previewRequest, null, null);

拍照时的特殊请求

拍照通常需要两步：测光 和 捕获。

// 第一步：发送测光请求
CaptureRequest.Builder stillCaptureBuilder =
        cameraDevice.createCaptureRequest(CameraDevice.TEMPLATE_STILL_CAPTURE);
// ... 设置和预览请求相同的参数 (对焦、曝光等)
// 发送预捕获触发，让相机进行准备工作
stillCaptureBuilder.set(CaptureRequest.CONTROL_AE_PRECAPTURE_TRIGGER,
        CaptureRequest.CONTROL_AE_PRECAPTURE_TRIGGER_START);
// 第二步：在收到测光完成的回调后，发送拍照请求
// 在 CameraCaptureSession.CaptureCallback 的 onCaptureProgressed 中
// 检查 CaptureResult.CONTROL_AE_STATE 是否为 CONTROL_AE_STATE_CONVERGED
// 如果已收敛，则执行拍照
// 创建拍照请求
stillCaptureBuilder.addTarget(imageReader.getSurface());
// ... 可以在这里设置 JPEG 方向
// int rotation = getWindowManager().getDefaultDisplay().getRotation();
// stillCaptureBuilder.set(CaptureRequest.JPEG_ORIENTATION, getCorrectOrientation(rotation, characteristics));
CaptureRequest captureRequest = stillCaptureBuilder.build();
cameraCaptureSession.capture(captureRequest, captureCallback, backgroundHandler);

重要注意事项

1. API 版本：

   
   （图片来源网络，侵删）
   • Camera (1.0) API：已废弃，仅用于维护旧项目。
   • Camera2 (API 21+)：现代 Android 开发的唯一选择，功能强大，但使用复杂，Google 提供了 CameraX 库来简化 Camera2 API 的使用。

2. 性能：

   • Camera2 是异步的，所有操作（打开相机、设置参数、拍照）都必须通过回调函数处理。
   • 频繁地设置 CaptureRequest 参数（尤其是在预览时）可能会影响性能，一旦设置好预览参数，就使用 setRepeatingRequest 来持续渲染预览画面。

3. 权限：

   • 从 Android 6.0 (API 23) 开始，相机访问需要运行时权限 Manifest.permission.CAMERA。
   • 如果你的 App 录音，还需要 Manifest.permission.RECORD_AUDIO。

4. 线程：

   • 所有与相机相关的回调（CameraDevice.StateCallback, CameraCaptureSession.CaptureCallback）都会在后台线程执行，不要在这些回调中进行耗时操作（如 UI 更新），应使用 Handler 将任务切换到主线程。

掌握 Android 相机参数，关键在于理解 CameraCharacteristics（能力）和 CaptureRequest（指令）的区别，通过查询 Characteristics 来了解相机能做什么，然后通过构建 Request 来告诉相机具体怎么做，在实践中，多查阅官方文档，并结合代码进行调试，是掌握这些参数的最佳途径。