第18讲 Reprocessable Capture Session详解二 - Android Camera2 API|极客笔记

本讲是Android Camera专题系列的第18讲，我们介绍Android Camera2 API专题的Reprocessable Capture Session详解二。

更多资源：

资源	描述
在线课程	极客笔记在线课程
知识星球	星球名称：深入浅出Android Camera 星球ID: 17296815
Wechat	极客笔记圈

InputConfiguration简介

InputConfiguration用于创建Reprocessable capture session.

如何使用 InputConfiguration

createReprocessableCaptureSession(InputConfiguration, List outputs, callback, handler)
createReprocessableCaptureSessionByConfigurations(InputConfiguration, List outputs, callback, handler)
createCaptureSession (SessionConfiguration config)

如何判断是否支持 Reprocessable

Capabilities中必须一种Reprocessable capability，才能支持配置InputConfiguration
- PRIVATE_REPROCESSING
- YUV_REPROCESSING

如何获取支持的Size和Format

API	Description
InputConfiguration(int width, int height, int format)	根据width，height和format创建InputConfiguration，这里的format必须来自StreamConfigurationMap#getinputsizes	API 23
InputConfiguration(Collection multiResolutionInputs, int format)	根据multiResolutionInputs和format创建InputConfiguration，这里的format必须来自MultiResolutionStreamConfigurationMap#getInputFormats()，表明从API 31开始Reprocessing也支持多分辨率输入	API 31
getFormat()	获取当前InputConfiguration的format	API 23
getHeight()	获取当前InputConfiguration的height	API 23
getWidth()	获取当前InputConfiguration的width	API 23
isMultiResolution()	是否为多分辨率的InputConfiguration，多分辨率的InputConfiguration意味着从它创建的Reprocessable Camera Capture Session允许输入不同大小的图像。	API 31

API	Description	API
createReprocessCaptureRequest(TotalCaptureResult inputResult)	根据TotalCaptureResult创建用于处理Reprocessing的CaptureRequest.Builder，这里的TotalCaptureResult与Input image必须匹配，通常通过Timestamp进行匹配。	API 23
createReprocessableCaptureSession (InputConfiguration inputConfig, List\ outputs, CameraCaptureSession.StateCallback callback, Handler handler)	deprecated in API level 30.创建Reprocessable CaptureSession	API 23
createReprocessableCaptureSessionByConfigurations (InputConfiguration inputConfig, List\ outputs, CameraCaptureSession.StateCallback callback, Handler handler)	deprecated in API level 30.创建Reprocessable CaptureSession	API 24
createCaptureSession(SessionConfiguration config)	根据SessionConfiguration来创建Reprocessable CaptureSession	API 28

API	Description	API
isReprocessable	判断是否可以通过该CameraCaptureSession submit Reprocessable capture requests	API 23
getInputSurface	获取Input Surface，注意这里只支持一个Input Surface，也没有必要支持多个Input Surfaces	API 23

App通过ImageWriter可以向Surface送一块Buffer

ImageWriter简介

ImageWriter queueInputImage Flow

ImageWriter queueInputImage Flow

API	Description	API
newInstance(Surface surface, int maxImages, int format)	根据format和maxImages创建ImageWriter	API 23
newInstance(Surface surface, int maxImages)	根据maxImages创建ImageWriter	API 23
setOnImageReleasedListener(ImageWriter.OnImageReleasedListener listener, Handler handler)	注册OnImageReleasedListener，当Consumer将Image归还给ImageWriter时会调用
dequeueInputImage()	从ImageWriter中Dequeue一张Image来填	API 23
getMaxImages()	能从ImageWriter中dequeue出来的最大Image数量。dequeueInputImage的数量超出maxImages时会发生IllegalStateException.	API 23
queueInputImage(Image image)	向ImageWriter Queue一张Image	API 23
getFormat()	获取ImageWriter的Buffer Format。	API 23
close()	释放该ImageWriter的所有资源，close后再使用该ImageWriter会发生IllegalStateException	API 23

newInstance(Surface surface, int maxImages)

newInstance(Surface surface, int maxImages, int format)

这里指定的format会覆盖Surface中的format
比如Surface来自SurfaceTexture默认是PixelFormat#RGBA_8888，这里的format是ImageFormat#PRIVATE，则Surface会被覆盖为ImageFormat#PRIVATE
注意：如果Surface的format与输入format有冲突，请确保Consumer能吃下输入format

从ImageWriter dequeue一张Image出来填写

填好后，通过queueInputImage(Image) 或 Image#close() 还给ImageWriter

无Image可用时（都在Consumer那边未Release），该方法会Block住

每当Consumer归还一张Buffer给ImageWriter时，OnImageReleasedListener#onImageReleased会被调用

ImageFormat#PRIVATE

向ImageWriter queue一张图

Image来源

ImageReader
- Image 属性(size, format, strides, etc.) 必须跟ImageWriter dequeue出来的Image属性完全一致.
- 如果ImageWriter没有free的Image可用，该方法会被block住
ImageWriter
- App负责向Image填数据

Timestamp