2. Camera API 演进：Camera1 vs Camera2 vs CameraX 架构差异与选型策略

Android 相机 API 自诞生以来经历了三次重大迭代：Camera1（旧版 API）、Camera2（新版 API）和 CameraX（Jetpack 扩展库）。每一次演进都解决了前一代的核心痛点，同时也引入了新的架构复杂度。理解这三者的差异，是正确设计预览数据通路的前提。

2.1 架构演进总览

下图展示了三代 API 在应用层与 HAL 层之间的架构位置与核心组件差异：

2.2 核心差异对比表

2.3 Camera1：历史包袱与局限

Camera1 是 Android 最早的相机 API，设计上采用阻塞式单线程模型。开发者通过 android.hardware.Camera 类直接操作硬件，预览流程如下：

1. 打开相机： Camera.open() 是阻塞调用，可能耗时 100-500ms。
2. 配置参数： 通过 Camera.Parameters 设置预览尺寸、帧率、对焦模式。
3. 绑定 Surface： setPreviewDisplay(SurfaceHolder) 将预览画面输出到 SurfaceView。
4. 启动预览： startPreview() 开始数据流。
5. 获取帧数据： setPreviewCallback() 在预览线程中回调 byte[] 数据（NV21 格式）。

2.4 Camera2：异步管道与精细控制

Camera2 重新设计了相机架构，引入 CaptureRequest / CaptureResult 异步模型和 BufferQueue 数据通路。核心组件包括：

• CameraManager： 系统服务代理，负责枚举摄像头、获取特性。
• CameraDevice： 代表打开的相机设备，异步回调方式操作。
• CameraCaptureSession： 管理 Surface 输出管道，支持多路复用。
• CaptureRequest： 描述一次捕获的参数和目标 Surface 列表。
• ImageReader： 提供 Surface 供 Session 写入，通过 OnImageAvailableListener 异步获取 Image 对象。

Camera2 预览数据通路的关键代码片段：

// 1. 获取 CameraManager
CameraManager manager = (CameraManager) getSystemService(CAMERA_SERVICE);

// 2. 打开相机（异步）
manager.openCamera(cameraId, new CameraDevice.StateCallback() {
    @Override
    public void onOpened(@NonNull CameraDevice camera) {
        // 3. 创建 CaptureSession
        List<Surface> outputs = new ArrayList<>();
        Surface previewSurface = surfaceView.getHolder().getSurface();
        outputs.add(previewSurface);

        // 可选：ImageReader 用于帧分析
        ImageReader reader = ImageReader.newInstance(width, height, ImageFormat.YUV_420_888, 2);
        reader.setOnImageAvailableListener(readerListener, backgroundHandler);
        outputs.add(reader.getSurface());

        camera.createCaptureSession(outputs, sessionCallback, backgroundHandler);
    }
}, backgroundHandler);

// 4. 发送重复预览请求
CaptureRequest.Builder builder = camera.createCaptureRequest(CameraDevice.TEMPLATE_PREVIEW);
builder.addTarget(previewSurface);
session.setRepeatingRequest(builder.build(), null, backgroundHandler);

2.5 CameraX：Jetpack 生态的易用性封装

CameraX 是 Google 在 2019 年推出的 Jetpack 相机库，本质上是 Camera2 的上层封装，但解决了 Camera2 最令人头疼的兼容性问题。其核心设计思想是 UseCase：

CameraX 预览绑定 Surface 的代码极为简洁：

// 1. 获取 ProcessCameraProvider
ProcessCameraProvider provider = ProcessCameraProvider.getInstance(context).get();

// 2. 绑定 Preview UseCase
Preview preview = new Preview.Builder()
    .setTargetResolution(new Size(1920, 1080))
    .build();

// 3. 设置 SurfaceProvider（自动绑定 PreviewView）
preview.setSurfaceProvider(previewView.getSurfaceProvider());

// 4. 绑定生命周期
Camera camera = provider.bindToLifecycle(
    lifecycleOwner,
    CameraSelector.DEFAULT_BACK_CAMERA,
    preview,
    imageAnalysis  // 可选：同时绑定分析 UseCase
);

2.6 选型决策树

根据项目需求选择 Camera API 的决策流程：

2.7 性能与数据通路对比

从预览数据通路的视角，三代 API 在延迟、内存开销和灵活性上的差异：

2.8 迁移建议与兼容策略

• 从 Camera1 迁移到 Camera2： 重点替换 Camera.open() 为 CameraManager.openCamera() 异步回调；将 setPreviewCallback 替换为 ImageReader + OnImageAvailableListener。
• 从 Camera2 迁移到 CameraX： 将 CameraDevice / CaptureSession 管理替换为 ProcessCameraProvider.bindToLifecycle()；将 ImageReader 替换为 ImageAnalysis UseCase。
• 混合使用： CameraX 内部仍使用 Camera2 API，可通过 CameraXConfig 自定义底层 Camera2 参数（如 Camera2CameraImpl）。
• 兼容性检测： 使用 CameraCharacteristics.INFO_SUPPORTED_HARDWARE_LEVEL 判断设备 Camera2 支持级别（LEGACY / LIMITED / FULL / LEVEL_3）。