极客笔记本讲是Android Camera专题系列的第14讲，我们介绍Android Camera2 API专题的OutputConfiguration API详解。
视频在线观看：
加入知识星球与更多Camera同学交流
- 星球名称：深入浅出Android Camera
- 星球ID: 17296815
Android Camera2 API课程体系
OutputConfiguration API概述
| API | 描述 |
|---|---|
| enableSurfaceSharing() | 使能多个Surfaces共享同一个OutputConfiguration |
| getMaxSharedSurfaceCount() | 获取当前OutputConfiguration最大可以被几个Surfaces Share，目前是4个 |
| removeSurface(Surface surface) | 删除不需要Share的Surface |
| addSurface(Surface surface) | 向OutputConfiguration增加一个Surface；Deferred Surface和Surface Sharing都需要调用该方法 |
| getSurfaceGroupId() | 获取该OutputConfiguration的Surface Group ID |
| setPhysicalCameraId(String physicalCameraId) | 设置该OutputConfiguration属于哪个Physical Camera |
| addSensorPixelModeUsed(int sensorPixelModeUsed) | 设置该OutputConfiguration的Sensor Pixel Mode |
| removeSensorPixelModeUsed(int sensorPixelModeUsed) | 移除之前Add过的Sensor Pixel Mode，如果移除未Add过的Sensor Pixel Mode会发生IllegalArgumentException |
| createInstancesForMultiResolutionOutput(MultiResolutionImageReader multiResolutionImageReader) | 通过MultiResolutionImageReader创建一个Multiresolution的OutputConfiguration列表 |
enableSurfaceSharing
当App配置的Stream数量超出底层支持的限制时，可以考虑使用Surface Sharing功能。
哪些Surfaces满足Surface Sharing的条件
-
相同的 size, format, dataSpace, 和 Surface source class，则一定可以Surface Sharing
-
相同的size, format, 和 dataSpace, 不同的Surface source，则不一定能支持Surface Sharing，如果用这样的OutputConfiguration配置来创建Camera Capture Session，成功则表示可以Share，失败则表示无法Share。
enableSurfaceSharing必须在createCaptureSessionByOutputConfigurations前设置。
通过getMaxSharedSurfaceCount获取当前OutputConfiguration最大支持多少个Surface share同一个stream，目前是hardcode写死为4个。
removeSurface
从OutputConfiguration中移除不需要Share的Surface
用于创建OutputConfiguration的Surface不能被Remove，也就是下列Surface无法被移除
-
通过构造函数直接传入的Surface
-
第一次调用addSurface的Deferred Surface
移除未Add过的Surface会发生IllegalArgumentException
addSurface
向OutputConfiguration增加一个Surface
- For sharing，重复add同一个Surface会发生 IllegalArgumentException
- Add Surface时要求Size，format，dataspace都一致，否则会发生IllegalArgumentException
Deferred Surface，用于增加已经Ready的Surface
setPhysicalCameraId
一个Logical Camera设备可能对应多个Physical Camera设备，App如何想获取某个Physical Camera的Stream，则需要通过该方法对OutputConfiguration设置Physical Camera ID
合法的Physical Camera ID需要从CameraCharacteristics.getPhysicalCameraIds获取
该方法必须在创建Camera Capture Session之前调用
对Reprocess的支持（待验证）
-
< Android 12：Physical camera stream不能作为Input stream
-
>= Android 12：Physical camera stream可以给logical camera stream reprocess，Physical camera stream可以给physical camera stream reprocess。
addSensorPixelModeUsed(待验证)
可设置的Sensor Pixel Mode
-
CameraMetadata.SENSOR_PIXEL_MODE_DEFAULT
- StreamConfigurationMap只能来自CameraCharacteristics.SCALER_STREAM_CONFIGURATION_MAP
-
CameraMetadata.SENSOR_PIXEL_MODE_MAXIMUM_RESOLUTION
- 支持的Capabilities中包含REQUEST_AVAILABLE_CAPABILITIES_ULTRA_HIGH_RESOLUTION_SENSOR 才能设置这种Sensor Pixel Mode
- StreamConfigurationMap只能来自CameraCharacteristics.SCALER_STREAM_CONFIGURATION_MAP_MAXIMUM_RESOLUTION
CaptureRequest需要搭配设置CaptureRequest.SENSOR_PIXEL_MODE参数
MultiResolutionImageReader(待验证)
MultiResolutionImageReader将多个ImageReader封装在一起，这些ImageReader具体如下特性
- 相同的format，不同的size或不同的Camera ID或不同的Sensor Mode
应用场景
-
Multi-Camera
- SAT 不同的Physical Camera有不同的Max Resolution，因此针对同一个Logical MultiCamera，在不同的Zoom值下，同一个format对应的Max Resolution可能不一样
-
Ultra high resolution sensor camera
- 会根据光照条件决定是否要Enable Remosaic Mode，所以拍照的分辨率可能会在最大分辨率和默认分辨率间切换
Stream Configuration Map
- CameraCharacteristics.SCALER_MULTI_RESOLUTION_STREAM_CONFIGURATION_MAP
