2. Result回调基础概念

2.1 什么是Result回调

在Camera HAL3架构中，Result回调是HAL层向Camera Framework上报拍摄结果的核心异步通信机制。当HAL完成一个Capture Request的处理后，通过process_capture_result函数将结果数据推送给Framework，而不是由Framework主动轮询。

Result回调的本质是一个异步通知通道，它携带了以下三类关键信息：

• 元数据（Metadata）：包含3A状态、传感器时间戳、曝光参数等控制结果。
• 输出缓冲区（Output Buffers）：经过ISP处理后的图像数据，如YUV、JPEG或RAW图。
• 部分结果（Partial Result）：允许HAL分批次上报，Framework可提前处理已就绪的数据。

2.2 Result与Request的对应关系

Result与Request之间遵循严格的1:N映射模型，但并非简单的“一个Request对应一个Result”。实际对应关系如下表所示：

对应关系的核心规则：

• 每个Request必须最终产生一个完整的Result（或错误状态）。
• Partial Result可以多次上报，但partial_result计数器必须递增至总次数。
• Buffer Result允许提前释放已处理的输出缓冲区，减少Framework端的内存压力。
• Framework通过frame_number将Result与原始Request关联，确保时序一致性。

2.3 Result数据流的基本路径

Result数据从HAL产生到Framework消费，经历了清晰的层级传递。下图展示了完整的Result数据流路径：

Result数据流的基本路径可以概括为以下步骤：

1. HAL产生结果：HAL完成某个Request的处理后，构造camera3_capture_result_t结构体，填充帧号、元数据、缓冲区列表和部分结果计数。
2. 跨进程传递：通过HIDL或AIDL接口，将Result数据从HAL进程传递到Camera Service进程。此过程涉及序列化/反序列化，对性能敏感。
3. Service校验与分发：Camera Service检查Result的合法性（帧号连续性、缓冲区状态等），然后通过内部回调机制分发给Framework层的CameraDevice实例。
4. Framework消费：Framework的CameraCaptureSession将Result转换为应用层可识别的CaptureResult对象，触发onCaptureCompleted或onCapturePartial回调。

2.4 关键数据结构

Result回调在HAL层对应的核心数据结构是camera3_capture_result_t，其关键字段如下：

typedef struct camera3_capture_result {
    uint32_t                frame_number;           // 对应Request的帧号
    const camera3_stream_buffer_t *output_buffers;  // 输出缓冲区数组
    uint32_t                num_output_buffers;     // 输出缓冲区数量
    const camera3_capture_result_metadata_t *result;// 结果元数据
    uint32_t                partial_result;         // 部分结果计数（0表示完整结果）
    int32_t                 error_stream;           // 错误流标识
    // ... 其他扩展字段
} camera3_capture_result_t;

其中partial_result字段是理解Result回调机制的关键：

• 值为0：表示这是该Request的最终完整Result，之后HAL不会再为该帧上报任何结果。
• 值为1~N：表示这是第几次部分结果上报，HAL必须保证从1开始递增，最终上报一次partial_result=0的完整结果。
• 值为-1：表示该Result仅包含缓冲区状态更新，不携带任何metadata。