3. Camera HIDL接口定义：ICameraProvider、ICameraDevice、ICameraDeviceSession等核心接口解析

在Camera HAL的HIDL服务化架构中，接口定义是连接Framework与HAL实现的契约。Android从Oreo开始引入Treble架构，将Camera HAL接口从传统的hardware/libhardware迁移至HIDL（HAL Interface Definition Language），实现了Framework与HAL的编译时解耦。本章将深入解析三个核心HIDL接口：ICameraProvider、ICameraDevice和ICameraDeviceSession，它们构成了Camera HAL服务启动与调用的主干。

3.1 接口层级关系与调用链路

三个核心接口在HIDL服务中的层级关系如下图所示。Framework通过CameraService与HAL通信，首先获取ICameraProvider，再通过Provider获取ICameraDevice，最后通过Device打开ICameraDeviceSession进行数据流处理。

3.2 ICameraProvider 接口详解

ICameraProvider是Camera HAL的入口接口，负责相机设备的发现、查询和生命周期管理。每个Camera HAL实现必须至少提供一个ICameraProvider服务实例。其核心方法如下表所示：

ICameraProvider的HIDL定义片段（以Android 12为例）：

interface ICameraProvider {
    getCameraIdList() generates (Status status, hidl_vec<string> cameraIds);
    getCameraDeviceInterface(string cameraId)
            generates (Status status, ICameraDevice device);
    setCallback(ICameraProviderCallback callback)
            generates (Status status);
    getVendorTags()
            generates (Status status, hidl_vec<VendorTagSection> vendorTagSections);
    isSetTorchModeSupported()
            generates (Status status, bool support);
};

3.3 ICameraDevice 接口详解

ICameraDevice代表一个具体的相机设备（物理或逻辑）。它负责提供相机静态信息、配置输出流、以及创建捕获会话。ICameraDevice是连接Provider与Session的桥梁。

ICameraDevice的HIDL定义片段：

interface ICameraDevice {
    getResourceCost() generates (Status status, CameraResourceCost cost);
    getCameraCharacteristics()
            generates (Status status, CameraMetadata characteristics);
    open(ICameraDeviceCallback callback)
            generates (Status status, ICameraDeviceSession session);
    setTorchMode(TorchMode mode) generates (Status status);
    dumpState(int fd) generates (Status status);
};

3.4 ICameraDeviceSession 接口详解

ICameraDeviceSession是实际处理捕获请求和返回结果的接口。它管理着从应用层下发Capture Request到HAL处理并返回Capture Result的完整流水线。Session的生命周期从open()成功返回开始，到设备关闭或异常断开结束。

ICameraDeviceSession的HIDL定义片段：

interface ICameraDeviceSession {
    constructDefaultRequestSettings(RequestTemplate type)
            generates (Status status, CameraMetadata requestTemplate);
    configureStreams(StreamConfiguration requestedConfiguration)
            generates (Status status, HalStreamConfiguration halConfiguration);
    processCaptureRequest(hidl_vec<CaptureRequest> requests)
            generates (Status status, uint32_t numRequestProcessed);
    flush() generates (Status status);
    close() generates (Status status);
};

3.5 接口调用流程与数据流

下图展示了从应用层下发Capture Request到HAL返回Capture Result的完整数据流，涉及三个核心接口的协作：

3.6 接口实现要点与常见问题

• ICameraProvider实现要点：
  • 必须在getCameraIdList()中返回稳定的cameraId顺序，避免Framework缓存失效。
  • setCallback()注册的回调必须妥善保存，用于热插拔通知（如USB Camera插拔）。
  • 若HAL支持多个Provider实例（如前后摄分离），需确保每个Provider的cameraId不冲突。
• ICameraDevice实现要点：
  • getCameraCharacteristics()返回的元数据必须与HAL实际能力一致，否则会导致Framework层校验失败。
  • open()方法中，若设备已被占用，应返回Status::CAMERA_IN_USE而非INTERNAL_ERROR。
  • 建议在open()中完成硬件初始化后，立即调用ICameraDeviceCallback::notify()发送CameraDeviceError::CAMERA_DEVICE_ERROR_NONE表示设备就绪。
• ICameraDeviceSession实现要点：
  • configureStreams()必须支持动态重配置（如从预览切换到录像），且需正确处理流数量变化。
  • processCaptureRequest()支持批量提交（hidl_vec），HAL应尽量并行处理以提高吞吐量。
  • flush()必须尽快停止所有正在处理的请求，并通过回调返回BufferStatus::ERROR给Framework。

3.7 接口版本演进与兼容性

Camera HIDL接口从Android 8.0（Oreo）的1.0版本演进到Android 12的3.7版本，每次升级都增加了新功能或优化了性能。下表总结了关键版本变化：

通过以上对ICameraProvider、ICameraDevice、ICameraDeviceSession三个核心接口的解析，可以看到Camera HIDL接口设计遵循了清晰的分层原则：Provider负责发现与生命周期，Device负责设备特性与连接，Session负责实际的捕获流水线。理解这些接口的职责与调用关系，是后续进行HIDL服务启动调试和性能优化的基础。