3. Stream概念解析：定义、类型与生命周期

在Camera HAL层中，Stream（数据流）是连接图像传感器与上层应用的核心抽象。一次成功的相机预览或拍照，本质上是HAL层正确配置并持续维护一组Stream的过程。Stream配置失败，直接导致黑屏、无数据回调或应用ANR。

3.1 Stream的定义

Stream是Android Camera框架中描述图像数据生产者与消费者之间单向数据通道的接口。每个Stream包含以下关键属性：

3.2 Stream的类型

根据图像数据的最终用途，Android Camera框架定义了三种核心Stream类型。每种类型对应不同的硬件处理路径和性能要求。

• Preview Stream： 持续输出低延迟帧，通常经过GPU合成后显示到SurfaceView/TextureView。黑屏问题最常见于Preview Stream配置失败。
• Still Capture Stream： 单次触发，输出高分辨率静止图像。HAL层需要切换ISP参数（降噪、锐化）并完成JPEG编码。
• Video Record Stream： 持续输出给MediaCodec编码器，对帧间隔稳定性要求高，Buffer队列深度较大。

3.3 Stream的生命周期

Stream从创建到销毁经历四个阶段。理解每个阶段的状态转换，是定位配置失败黑屏的关键。

3.4 各阶段详细说明

1. IDLE（空闲态）
   • Stream对象已创建，但未与任何硬件管线绑定。
   • 此时仅保存应用传入的配置参数（宽高、格式、usage）。
2. CONFIGURING（配置态）
   • HAL层收到 configure_streams() 调用，开始校验参数并分配硬件资源。
   • 常见失败原因：分辨率超出ISP最大支持、Format不匹配、多个Stream总带宽超限。
   • 若失败，直接跳转到ERROR态，configure_streams() 返回 -EINVAL 或 -ENODEV。
3. ACTIVE（活跃态）
   • Stream成功绑定硬件管线，开始持续输出帧数据。
   • HAL层通过 process_capture_request() 接收上层请求，填充输出Buffer。
   • 若运行中发生硬件异常（如MIPI失锁、ISP超时），Stream转入ERROR态。
4. ERROR / DESTROYED（错误/销毁态）
   • ERROR态：Stream不可用，需要上层调用 close() 或重新 configure_streams() 恢复。
   • DESTROYED态：Stream对象被销毁，所有Buffer归还Gralloc，硬件资源释放。

3.5 Stream配置与黑屏的关联

以下表格总结了Stream配置失败导致黑屏的典型场景：