2. HAL3接口定义：ICameraDevice.hal与ICameraDeviceSession.hal的核心接口方法

在Android Camera HAL3架构中，ICameraDevice.hal和ICameraDeviceSession.hal是连接Framework与HAL实现的核心契约。前者负责设备级别的生命周期管理与流配置，后者负责具体Capture请求的提交与结果回调。理解这两个接口的核心方法，是掌握Camera3Device初始化流程的关键前提。

2.1 ICameraDevice.hal 核心接口方法

ICameraDevice.hal定义了Camera HAL设备对外暴露的入口方法，主要包括设备打开、资源销毁、流配置协商以及Session创建。下表列出了其核心方法及语义：

下面通过SVG图展示ICameraDevice.hal接口在Camera3Device初始化流程中的调用关系：

2.2 ICameraDeviceSession.hal 核心接口方法

ICameraDeviceSession.hal是实际执行拍照任务的接口。一旦Session创建成功，Framework便通过此接口下发Capture请求、回收Buffer、处理结果。其核心方法如下：

下面通过SVG图展示ICameraDeviceSession.hal接口在Capture阶段的工作流程：

2.3 两个接口的职责边界与协作关系

ICameraDevice与ICameraDeviceSession的职责边界非常清晰，理解这一点有助于正确实现HAL：

• 生命周期归属：ICameraDevice管理设备级别的生命周期（open/close），ICameraDeviceSession管理会话级别的生命周期（process/flush/close）。一个ICameraDevice可以依次创建多个Session，但同一时间只能有一个活跃Session。
• 流配置归属：流配置（StreamConfiguration）的协商在ICameraDevice侧完成（isSessionConfigurationSupported），但流的实际创建和绑定在ICameraDeviceSession的createSession（或configureStreams）中执行。
• 数据路径归属：所有Capture请求、结果回调、Buffer操作全部通过ICameraDeviceSession完成。ICameraDevice不参与任何帧处理。
• 错误上报归属：设备级别的致命错误（如硬件断开）通过ICameraDeviceCallback上报；会话级别的错误（如某个Stream超时）通过ICameraDeviceSessionCallback上报。

2.4 接口方法在HAL实现中的典型代码骨架

以下是一个简化的HAL实现骨架，展示ICameraDevice和ICameraDeviceSession核心方法的实现模式：

// ICameraDevice HAL 实现片段
Return<Status> CameraDeviceImpl::open(
    const sp<ICameraDeviceCallback>& callback) {
    // 1. 保存Framework回调
    mCallback = callback;
    // 2. 初始化硬件资源（电源、时钟、I2C）
    // 3. 启动传感器预览流（可选）
    mSensor = new CameraSensor();
    mSensor->powerOn();
    return Status::OK;
}

Return<Status, sp<ICameraDeviceSession>> 
CameraDeviceImpl::createSession(
    const StreamConfiguration& config,
    const sp<ICameraDeviceSessionCallback>& cb) {
    // 1. 验证流配置合法性
    for (auto& stream : config.streams) {
        if (!isStreamFormatSupported(stream.format)) {
            return {Status::BAD_VALUE, nullptr};
        }
    }
    // 2. 创建Session实现
    sp<CameraSessionImpl> session = new CameraSessionImpl(mSensor, config, cb);
    // 3. 初始化ISP管线、分配Buffer
    session->initializePipeline();
    // 4. 返回Session接口
    return {Status::OK, session};
}

// ICameraDeviceSession HAL 实现片段
Return<Status> CameraSessionImpl::processCaptureRequest(
    const hidl_vec<CaptureRequest>& requests,
    const hidl_vec<BufferCache>& caches) {
    for (auto& req : requests) {
        // 1. 将请求加入内部队列
        mRequestQueue.push_back(req);
        // 2. 触发硬件处理（非阻塞）
        mSensor->triggerCapture(req);
        // 3. 通过回调异步上报结果
        //    mCallback->processCaptureResult(result);
    }
    return Status::OK;
}

Return<Status> CameraSessionImpl::flush() {
    // 1. 清空请求队列
    mRequestQueue.clear();
    // 2. 终止当前正在执行的Capture
    mSensor->abortCapture();
    // 3. 通知Framework所有未完成的请求已丢弃
    return Status::OK;
}

2.5 接口版本演进与兼容性说明

Android Camera HAL3接口经历了多次小版本迭代，不同Android版本对接口方法的要求有所不同：