3. CameraDevice.open() 深度解析：open流程、权限检查、设备状态机、异常处理

CameraDevice.open() 是 Camera2 框架中应用层与相机硬件建立连接的第一道关口。这个调用看似简单，背后却涉及权限验证、状态机跃迁、HAL 层初始化以及多级异常处理。理解 open 的完整流程，是后续 Pipeline 调优的基础。

3.1 open() 调用流程全景

从应用层调用 CameraManager.openCamera() 到 CameraDevice 实例就绪，整体流程分为四个阶段：

1. 权限预检：检查应用是否持有 CAMERA 权限，以及设备是否被其他进程占用。
2. 状态机跃迁：CameraService 将设备状态从 UNOPENED 切换至 OPENING，并锁定设备。
3. HAL 初始化：通过 Camera HAL 接口调用 open()，完成硬件资源分配与流模板初始化。
4. 回调通知：通过 CameraDevice.StateCallback 返回 onOpened() 或 onError()。

3.2 权限检查机制

权限检查发生在 CameraService 端，分为三个层级：

3.3 设备状态机跃迁

CameraDevice 内部维护一个严格的状态机，open() 操作触发从 UNOPENED 到 OPENING 再到 OPENED 的跃迁。状态定义如下：

3.4 异常处理与错误码

open() 调用可能抛出以下异常，应用层必须妥善处理：

// 标准异常处理模板
try {
    cameraManager.openCamera(cameraId, stateCallback, backgroundHandler);
} catch (CameraAccessException e) {
    switch (e.getReason()) {
        case CameraAccessException.CAMERA_IN_USE:
            // 设备被其他应用占用，建议等待后重试
            break;
        case CameraAccessException.MAX_CAMERAS_IN_USE:
            // 系统相机数量已达上限
            break;
        case CameraAccessException.CAMERA_DISABLED:
            // 设备被策略禁用（如设备管理员限制）
            break;
        case CameraAccessException.CAMERA_DISCONNECTED:
            // 设备已断开（如 USB 相机拔出）
            break;
    }
} catch (SecurityException e) {
    // 权限不足，引导用户授权
}

3.5 性能调优：open 延迟分析

从性能角度，open() 的耗时分布通常如下：

3.6 实战：open 失败排查清单

当 open() 返回 onError() 时，按以下清单快速定位：

1. 检查 logcat：搜索 CameraService、CameraDeviceClient 关键字，定位错误码。
2. 验证 cameraId：确保 cameraId 来自 CameraManager.getCameraIdList()，而非硬编码。
3. 确认权限：运行时权限是否已授予？设备管理员是否禁用了相机？
4. 检查并发：是否有其他进程（如系统相机）占用了同一设备？
5. HAL 层 dump：通过 dumpsys media.camera 查看 HAL 状态，确认是否卡在初始化阶段。