2. AIDL基础与核心概念：语法、数据类型、定向tag与oneway

在Camera HAL多进程架构中，AIDL（Android Interface Definition Language）是连接Framework与HAL Service的通信契约。本章聚焦AIDL的核心语法、数据类型映射规则、参数定向tag（in/out/inout）以及oneway关键字的底层行为，为后续调试AIDL服务提供理论基石。

2.1 AIDL语法结构

AIDL文件定义了一个跨进程接口，其语法与Java接口高度相似，但仅支持方法声明，不支持静态常量、内部类或方法体。一个标准的AIDL接口包含包声明、导入语句、接口定义与方法签名。

// ICameraService.aidl
package android.hardware.camera;

import android.hardware.camera.CameraMetadata;  // 自定义Parcelable

interface ICameraService {
    int openCamera(in String cameraId, in ICameraClient client);
    CameraMetadata getCameraCharacteristics(in String cameraId);
    void setTorchMode(in String cameraId, boolean enabled);
    void notifyCameraState(in String cameraId, int newState);
}

2.2 数据类型映射

AIDL支持的数据类型分为三类：基本类型、Parcelable类型与AIDL接口类型。下表列出了Camera HAL开发中最常用的映射关系：

2.3 定向tag：in / out / inout

定向tag定义了参数在跨进程传输时的数据流向，直接影响Binder驱动的序列化与反序列化行为。理解tag的语义是避免数据丢失或性能浪费的关键。

2.4 oneway关键字

oneway关键字修饰AIDL方法，表示该方法为异步调用。调用方在发送请求后立即返回，不等待服务端处理完成。在Camera HAL中，oneway常用于回调接口和事件通知，以避免服务端阻塞客户端。

// 回调接口示例：ICameraCallback.aidl
package android.hardware.camera;

oneway interface ICameraCallback {
    void onFrameAvailable(in long timestamp);
    void onError(in int errorCode, in String errorMsg);
    void onCameraDisconnected();
}

2.5 综合示例：Camera HAL AIDL接口定义

以下是一个简化的Camera HAL AIDL接口，综合运用了上述所有核心概念：

// ICameraHalService.aidl
package android.hardware.camera.hal;

import android.hardware.camera.hal.CameraConfig;
import android.hardware.camera.hal.ICameraHalCallback;

interface ICameraHalService {
    // 同步：打开相机，返回会话句柄
    int openCamera(in String cameraId, out CameraConfig config);

    // 同步：配置预览参数
    boolean configureStreams(in int streamType, in int width, in int height);

    // 同步：获取元数据（out参数）
    void getCameraMetadata(in String cameraId, out byte[] metadata);

    // 异步：注册回调接口（oneway）
    oneway void setCallback(in ICameraHalCallback callback);

    // 异步：触发捕获（oneway，无返回值）
    oneway void triggerCapture(in int captureId);
}

// ICameraHalCallback.aidl
package android.hardware.camera.hal;

oneway interface ICameraHalCallback {
    void onCaptureCompleted(in int captureId, in long timestamp);
    void onError(in int errorCode);
}