4. Camera AIDL 接口设计原则：接口粒度、回调设计、版本管理策略

在 Camera HAL 从 HIDL 向 AIDL 迁移的过程中，接口设计是决定架构可扩展性、跨进程性能以及长期维护成本的核心环节。本章围绕 接口粒度、回调设计 与 版本管理策略 三大原则展开，为后续具体接口定义提供设计依据。

4.1 接口粒度设计原则

接口粒度直接影响跨进程调用的次数与数据吞吐量。粒度过细会导致频繁 Binder 交互，增加延迟；粒度过粗则降低复用性，难以适配多厂商扩展需求。

4.1.1 粒度分级策略

4.1.2 接口聚合模式

推荐使用 Bundle 模式 将多个相关参数打包为单一 AIDL 结构体，减少跨进程序列化开销。例如将 CaptureRequest 中的所有控制参数聚合为一个 RequestSettings 对象：

// 推荐：聚合接口
interface ICameraDevice {
    void submitRequest(in RequestSettings settings, in OutputConfiguration output);
}

// 不推荐：分散接口
interface ICameraDevice {
    void setExposureTime(long ns);
    void setSensitivity(int iso);
    void setOutputSurface(in Surface surface);
    void submit();
}

4.2 回调设计原则

回调是 Camera HAL 向 Framework 异步通知事件（如帧完成、错误、3A 收敛）的核心机制。AIDL 回调设计需遵循 单向（oneway）、轻量、可取消 三大原则。

4.2.1 单向回调（Oneway）

所有回调接口必须声明为 oneway，避免回调线程阻塞 HAL 的异步处理流程：

// 正确：oneway 回调
interface ICameraDeviceCallback {
    oneway void onCaptureCompleted(in CaptureResult result);
    oneway void onError(in ErrorCode code, in String message);
}

// 错误：同步回调可能导致死锁
interface ICameraDeviceCallback {
    void onCaptureCompleted(in CaptureResult result);  // 可能阻塞 HAL
}

4.2.2 回调注册与生命周期管理

回调必须支持动态注册与注销，防止内存泄漏或野指针。设计模式如下：

• 注册：Framework 通过 setCallback() 传入回调对象
• 注销：Framework 通过 clearCallback() 或传递 null 解除绑定
• 死亡通知：HAL 端监听 Binder 死亡通知，自动清理回调引用

interface ICameraDevice {
    void setCallback(in ICameraDeviceCallback callback);
    void clearCallback();
}

4.2.3 回调频率控制

高频回调（如预览帧回调）必须支持 节流（Throttling） 或 批量上报，避免 Binder 通道拥塞：

4.3 版本管理策略

AIDL 接口的版本管理直接决定 HAL 与 Framework 的兼容性。Camera HAL 采用 语义化版本 + 接口冻结 策略，确保向前兼容。

4.3.1 版本号定义规范

4.3.2 接口冻结与扩展机制

已发布的 MAJOR 版本接口必须 冻结，不允许修改已有方法签名。扩展功能通过以下方式实现：

• 新增接口：在 ICameraDevice 中追加 @VendorExtension 注解的方法
• 新增枚举值：Framework 端使用 default 分支处理未知枚举
• 新增回调：通过 ICameraDeviceCallbackV2 继承扩展，不修改原始回调接口

// 版本扩展示例：V2 回调继承 V1
interface ICameraDeviceCallbackV2 extends ICameraDeviceCallback {
    oneway void onCaptureProgressed(in CaptureResult result);  // V2 新增
}

4.3.3 版本协商流程

Framework 与 HAL 在初始化阶段通过 getInterfaceVersion() 进行版本协商：

1. Framework 调用 getInterfaceVersion() 获取 HAL 支持的版本
2. Framework 根据自身支持的版本范围，选择最高兼容版本
3. 若版本不匹配，Framework 降级使用基础功能或报错

4.4 接口设计全景图

以下 SVG 图展示了 Camera AIDL 接口设计中粒度、回调与版本管理的整体关系：

4.5 设计原则总结