Camera HAL框架：Metadata流转与请求管线调试 - 第1节

1.1 Android Camera HAL 架构演进

Android Camera HAL（硬件抽象层）是连接 Android 框架与底层摄像头硬件的关键中间层。自 Android 诞生以来，Camera HAL 经历了从 HAL1 到 HAL3 的重大架构演进，每一次迭代都旨在解决性能瓶颈、提升灵活性并满足日益复杂的拍照与视频需求。

1.1.1 架构演进路线图

下图展示了从 Android 早期到当前主流版本的 Camera HAL 架构演进脉络：

1.1.2 各阶段关键特征

1.2 HAL3 vs HAL1 核心差异

理解 HAL3 与 HAL1 的差异，是掌握 Camera HAL 框架的基石。两者在架构哲学、数据流模型、控制粒度以及性能表现上存在本质区别。

1.2.1 架构模型对比

1.2.2 关键差异对照表

1.3 HAL3 接口定义与职责

HAL3 的核心接口定义在 hardware/libhardware/include/hardware/camera3.h 中。整个 HAL3 设备围绕 camera3_device_t 结构体及其回调函数展开。

1.3.1 核心数据结构

HAL3 的接口设计围绕三个核心数据结构：

• camera3_device_t：代表一个打开的相机设备，包含所有操作函数指针。
• camera3_capture_request_t：描述一次捕获请求，包含输出 buffer、metadata、输入 buffer（ reprocess 场景）等。
• camera3_capture_result_t：描述一次捕获结果，包含输出 buffer、result metadata、部分结果状态等。

// camera3.h 核心结构体示意
typedef struct camera3_device {
    hw_device_t common;
    // HAL3 核心操作函数指针
    int (*initialize)(const struct camera3_device *, 
                      const camera3_callback_ops_t *callback_ops);
    int (*configure_streams)(const struct camera3_device *,
                             camera3_stream_configuration_t *config);
    int (*register_stream_buffers)(const struct camera3_device *,
                                   const camera3_stream_buffer_set_t *buffer_set);
    const camera_metadata_t *(*construct_default_request_settings)(
        const struct camera3_device *, int type);
    int (*process_capture_request)(const struct camera3_device *,
                                   camera3_capture_request_t *request);
    void (*dump)(const struct camera3_device *, int fd);
    int (*flush)(const struct camera3_device *);
    void (*signal_stream_flush)(const struct camera3_device *,
                                uint32_t num_streams,
                                const camera3_stream_t *const *streams);
    // ... 其他函数
} camera3_device_t;

1.3.2 核心接口职责

1.3.3 请求-结果生命周期

1.3.4 HAL3 实现职责清单

作为 HAL 实现者，需要承担以下关键职责：

1. 流管理：根据 configure_streams 配置，分配和管理所有输出流的 buffer 池。
2. 请求调度：维护一个请求队列，按序或按优先级提交给底层硬件处理。
3. Metadata 处理：解析 request metadata，将其转换为 sensor/ISP 寄存器配置；收集结果 metadata 并返回。
4. 3A 控制：实现自动曝光（AE）、自动对焦（AF）、自动白平衡（AWB）算法，或桥接底层 3A 库。
5. 错误处理：当 sensor 故障、buffer 超时、请求无效时，通过 notify 回调上报错误。
6. 性能保障：确保 process_capture_request 非阻塞；flush 操作在 1 秒内完成。

1.3.5 回调接口

HAL3 通过 camera3_callback_ops_t 向 CameraService 发送结果和通知：

typedef struct camera3_callback_ops {
    // 返回一个捕获结果（包含 metadata 和 buffer）
    void (*process_capture_result)(const struct camera3_callback_ops *,
                                   const camera3_capture_result_t *result);
    // 发送异步通知（如错误、快门事件等）
    void (*notify)(const struct camera3_callback_ops *,
                   const camera3_notify_msg_t *msg);
    // 查询 buffer 是否已由服务端释放（可选）
    int (*query_buffer)(const struct camera3_callback_ops *,
                        uint32_t stream_id,
                        uint32_t frame_number);
} camera3_callback_ops_t;

这些回调是 HAL 与 Framework 之间的唯一异步通信通道，必须保证线程安全且高效。