4. Camera HIDL 接口定义（ICameraDevice）

ICameraDevice.hal 是 Camera HAL 开发中 最核心 的接口文件，它定义了上层框架（Camera Service）与 HAL 实现之间的通信契约。本章将深入分析该接口中的四个核心方法：open、close、configureStreams 和 processCaptureRequest，理解它们的调用时机、参数含义以及实现要点。

4.1 接口概览与调用链路

在 Android HIDL 架构中，ICameraDevice 继承自 android.hardware.camera.device@3.2::ICameraDevice（或更高版本）。上层通过 ICameraService::connectDevice() 获取到 ICameraDevice 的代理对象，然后依次调用其方法完成相机生命周期管理。

4.2 open() —— 打开相机设备

open() 是 ICameraDevice 的入口方法，上层调用它来获取一个相机设备的操作句柄。其 HIDL 定义如下：

// ICameraDevice.hal (Android 10+)
interface ICameraDevice {
    open(ICameraDeviceCallback callback)
        generates (Status status, ICameraDeviceSession session);
    // ...
};

4.3 close() —— 关闭相机设备

close() 是资源释放的终点。当上层不再使用相机时（如用户退出相机应用），会调用此方法。其定义通常为：

// ICameraDeviceSession.hal
interface ICameraDeviceSession {
    close()
        generates (Status status);
    // ...
};

4.4 configureStreams() —— 配置数据流

configureStreams() 是 HAL 开发中最复杂的方法之一。它负责根据上层需求，配置相机输出的数据流组合（如预览流 + 拍照流 + 录像流）。

// ICameraDeviceSession.hal
configureStreams(StreamConfiguration config)
    generates (Status status, StreamConfiguration outConfig);

StreamConfiguration 结构体包含：

• streams：一个 Stream 数组，每个 Stream 定义了分辨率、格式、用途（PREVIEW / STILL_CAPTURE / VIDEO_RECORD / ZSL 等）
• operationMode：操作模式，如 NORMAL / CONSTRAINED_HIGH_SPEED（高速连拍）
• sessionParams：可选的会话级参数（如 HDR 模式、帧率范围）

4.5 processCaptureRequest() —— 提交捕获请求

processCaptureRequest() 是 HAL 的“工作马”，每次拍照、每一帧预览都通过它提交。其定义如下：

// ICameraDeviceSession.hal
processCaptureRequest(vec<CaptureRequest> requests,
                      vec<BufferCache> cachesToRemove)
    generates (Status status, uint32_t numRequestProcessed);

CaptureRequest 结构体包含：

典型处理流程：

1. 解析请求：提取 frameNumber、settings、outputBuffers
2. 参数生效：将 settings 中的 3A 参数写入 sensor 驱动（如通过 V4L2 的 VIDIOC_S_EXT_CTRLS）
3. 触发捕获：向 sensor 发送 trigger（如 software trigger 或 hardware trigger）
4. 等待完成：等待 sensor 输出 RAW 数据，经过 ISP 处理后填入 outputBuffers
5. 回调结果：通过 ICameraDeviceCallback::processCaptureResult() 返回结果元数据和填充好的缓冲区

4.6 方法对比总结