1. Camera HAL架构概述
1.1 Android Camera HAL整体架构
Android Camera HAL（Hardware Abstraction Layer）位于Android框架与底层相机硬件驱动之间，是连接应用层与硬件层的桥梁。HAL层定义了标准接口，使上层框架无需关心具体硬件实现细节，从而保证不同厂商的相机硬件能够在Android系统中正常工作。
核心定位： Camera HAL是Android相机子系统的硬件抽象边界，向上为Camera Framework提供统一的设备操作接口，向下直接与V4L2、ISP驱动等内核空间交互。
整体架构从顶层到底层依次为：
- Application层 — 相机应用通过Camera2 API发起请求
- Camera Framework层 — 位于system/server，管理CameraService、CameraDeviceClient等核心服务
- Camera HAL层 — 实现硬件抽象接口，处理请求/结果流
- Kernel层 — V4L2驱动、ISP驱动、传感器驱动等
1.2 HAL3与HAL1的区别
Android Camera HAL经历了从HAL1到HAL3的重大演进。HAL1是早期版本，设计简单但功能受限；HAL3是当前主流版本，支持更复杂的拍照场景和更高的性能要求。两者在架构设计、数据流模型、回调机制等方面存在本质差异。
| 对比维度 | HAL1 | HAL3 |
|---|---|---|
| 设计理念 | 基于回调的简单模型，一次一帧 | 基于Pipeline的请求-结果模型，支持并发 |
| 数据流模型 | 同步/半同步，预览和拍照分离 | 异步Pipeline，预览/拍照/录像统一为Capture Request |
| Result回调 | 单一回调接口，返回原始帧数据 | 多级回调：process_capture_result、notify、process_request |
| 元数据支持 | 有限，仅基础参数 | 完整metadata（AE/AWB/AF状态、统计信息等） |
| 多摄像头 | 不支持 | 原生支持多摄像头同步 |
| 性能优化 | 延迟较高，吞吐量有限 | 支持ZSL、高速连拍、高帧率录制 |
| Android版本 | Android 4.x ~ 7.x（已废弃） | Android 5.0+（当前主流） |
关键结论： HAL3的Result回调机制是课程的核心研究对象。相比HAL1的简单回调，HAL3通过
process_capture_result实现了异步、多buffer、带完整metadata的结果返回，这是现代相机功能的基础。
1.3 Result回调在HAL中的定位
Result回调是Camera HAL层向Framework层传递拍摄结果的核心通道。在HAL3架构中，一次完整的Capture流程包含三个关键阶段：Request提交 → 硬件处理 → Result回调。Result回调处于流程末端，负责将硬件生成的图像数据和元数据返回给上层。
Result回调在HAL层中的具体职责包括：
- 传递拍摄结果元数据 — 包含AE/AWB/AF状态、传感器时间戳、统计信息等
- 返回图像缓冲区 — 通过
camera3_stream_buffer结构体传递已填充的图像数据 - 支持分阶段回调 — 通过
partial_result机制，允许HAL在完整结果准备好之前先返回部分元数据 - 错误通知 — 通过
notify回调报告硬件错误、请求超时等异常情况 - 同步与排序 — 保证多个并发请求的结果按正确顺序返回给Framework
常见误区： Result回调并非简单的"拍照完成通知"。在HAL3中，一次Capture可能触发多次
process_capture_result调用（partial结果+最终结果），且多个请求的结果可能交错返回。正确理解回调的异步性和时序关系是HAL开发的关键难点。