4. Preview Request 流程详解：从 Framework 下发 CaptureRequest 到 HAL 的完整路径

Preview 流程的起点是 Android Framework 的 Camera 应用层，终点是 HAL 层的硬件处理单元。本章将深入剖析 CaptureRequest 从 Framework 下发到 HAL 的完整路径，并详细解析核心数据结构 camera3_capture_request_t 的每个字段。

4.1 整体流程概览

一个 Preview Request 的生命周期跨越 Framework、Camera Service、Camera Provider 和 HAL 四个层级。下图展示了从应用层调用 capture 到 HAL 接收 process_capture_request 的完整路径。

4.2 关键路径步骤详解

从 Framework 到 HAL 的完整路径包含以下关键步骤：

1. 应用层发起请求：应用通过 CameraCaptureSession.capture() 或 setRepeatingRequest() 提交 CaptureRequest。
2. Framework 层封装：CameraDeviceImpl 将请求封装为 CaptureRequest 对象，包含 metadata 和 target surfaces。
3. Camera Service 调度：Camera3Device 的 RequestThread 将请求加入队列，按优先级和帧号调度。
4. 跨进程传输：通过 Binder 将 CaptureRequest 序列化后传输到 Camera Provider 进程。
5. HAL 层转换：Camera Provider 调用 convertRequestToHAL() 将 Framework 请求转换为 camera3_capture_request_t。
6. HAL 回调：调用 process_capture_request() 将请求下发到 HAL 实现。

4.3 核心数据结构：camera3_capture_request_t 字段解析

camera3_capture_request_t 是 HAL 层接收请求的核心数据结构，定义在 hardware/libhardware/include/hardware/camera3.h 中。下表详细解析每个字段的含义和用途：

4.4 camera3_stream_buffer_t 结构解析

camera3_stream_buffer_t 是 camera3_capture_request_t 中描述 buffer 的核心子结构：

4.5 Framework 到 HAL 的转换流程

以下代码展示了 Camera3Device 如何将 Framework 的 CaptureRequest 转换为 HAL 的 camera3_capture_request_t：

// frameworks/av/services/camera/libcameraservice/device3/Camera3Device.cpp
status_t Camera3Device::convertRequestToHAL(
        const CaptureRequest &frameworkRequest,
        camera3_capture_request_t *halRequest) {
    
    // 1. 填充 frame_number
    halRequest->frame_number = frameworkRequest.mFrameNumber;
    
    // 2. 转换 metadata
    halRequest->settings = frameworkRequest.mSettings.get();
    
    // 3. 处理 input buffer（Preview 通常为 NULL）
    halRequest->input_buffer = nullptr;
    
    // 4. 构建 output buffers 数组
    Vector<camera3_stream_buffer_t> outputBuffers;
    for (auto &surface : frameworkRequest.mSurfaceList) {
        camera3_stream_buffer_t buf;
        buf.stream = getStreamForSurface(surface);
        buf.buffer = getBufferForSurface(surface);
        buf.status = CAMERA3_BUFFER_STATUS_OK;
        buf.acquire_fence = -1;
        buf.release_fence = -1;
        outputBuffers.add(buf);
    }
    halRequest->num_output_buffers = outputBuffers.size();
    halRequest->output_buffers = outputBuffers.array();
    
    // 5. 处理物理 camera settings
    halRequest->num_physcam_settings = 0;
    halRequest->physcam_settings = nullptr;
    
    return OK;
}

4.6 Preview 场景下的字段填充示例

以一个典型的 1080p Preview 请求为例，各字段的实际填充值如下：

4.7 性能关键点与优化建议

4.8 路径总结

Preview Request 从 Framework 到 HAL 的完整路径可概括为：

• 应用层：构建 CaptureRequest.Builder，设置 metadata 和 target surfaces。
• Framework 层：CameraDeviceImpl 封装为 CaptureRequest，通过 Binder 发送到 Camera Service。
• Service 层：Camera3Device 的 RequestThread 调度请求，调用 convertRequestToHAL() 转换。
• Provider 层：通过 HAL Binder 接口将 camera3_capture_request_t 传递给 HAL。
• HAL 层：process_capture_request() 接收请求，解析 settings 和 output_buffers，开始 ISP 处理。