
在使用 camera2 constrainedhighspeedcapturesession 进行 120fps 视频录制时,无法通过 imagereader 获取预览帧——因其仅支持预览(surfaceview/surfacetexture)或录制(mediarecorder/mediacodec)两类 surface,而 imagereader 不在此列。
在使用 camera2 constrainedhighspeedcapturesession 进行 120fps 视频录制时,无法通过 imagereader 获取预览帧——因其仅支持预览(surfaceview/surfacetexture)或录制(mediarecorder/mediacodec)两类 surface,而 imagereader 不在此列。
Android 的 CameraConstrainedHighSpeedCaptureSession 是专为高帧率(如 120FPS)视频录制设计的受限会话模式。正如其名,“constrained” 意味着它对输出 Surface 类型有严格限制:仅允许最多两个 Surface,且必须是以下之一:
- 预览用 Surface:来自
SurfaceView或SurfaceTexture - 录制用 Surface:来自
MediaRecorder.getSurface()或MediaCodec.createInputSurface()
因此,你当前尝试通过 ImageReader.newInstance(...) 创建 YUV 帧接收器并将其作为 Target Surface 添加到高速会话中,将必然失败,并抛出类似 Surface is not supported 的异常——因为 ImageReader.getSurface() 明确不在白名单内。
✅ 正确可行的替代方案是:利用 SurfaceTexture 实现 GPU 端帧级分析
SurfaceTexture 允许你将相机输出渲染至 OpenGL ES 纹理,从而在不阻塞高速流水线的前提下,以低延迟方式访问每一帧(通过 onFrameAvailable() 回调触发)。典型流程如下:
远程控制 Android 设备,支持截图、自动化操作手机 App 等功能。本应用使用 uiautomator2 作为底层框架,通过 ADB 连接设备,用户无需 Root(1)查看手机屏幕;(2)自动化操作手机 App;(3)远程安装/卸载应用……
private lateinit var surfaceTexture: SurfaceTexture
private val textureId = IntArray(1)
// 1. 创建 OpenGL 纹理
GLES20.glGenTextures(1, textureId, 0)
surfaceTexture = SurfaceTexture(textureId[0]).apply {
setDefaultBufferSize(previewSize.width, previewSize.height)
setOnFrameAvailableListener {
// ✅ 每帧到达时回调(注意:需在 GL 线程中 updateTexImage())
handler.obtainMessage(MSG_UPDATE_TEXTURE).sendToTarget()
}
}
// 2. 将 SurfaceTexture 传入高速会话(合法!)
val previewSurface = surfaceTexture.surface
val recordingSurface = mediaRecorder.surface // 或 MediaCodec 输入 Surface
cameraDevice.createConstrainedHighSpeedCaptureSession(
listOf(previewSurface, recordingSurface),
object : CameraCaptureSession.StateCallback() { /* ... */ },
backgroundHandler
)
⚠️ 注意事项:
-
SurfaceTexture.updateTexImage()必须在绑定该纹理的 OpenGL 上下文线程中调用(不可在主线程或任意 Handler 线程直接执行),建议使用HandlerThread + EGLContext构建专用 GL 线程; - 若需 CPU 端图像数据(如 OpenCV 处理),可在 GL 线程中调用
glReadPixels()同步读取,但会显著增加 GPU-CPU 同步开销,可能影响 120FPS 稳定性; - 避免在
onFrameAvailable中执行耗时操作(如 JNI 计算、内存拷贝),应仅作信号通知,将分析逻辑异步分发至工作线程; -
CameraX当前(截至 AndroidX Camera 1.3)确实不支持 Constrained High Speed 模式,故 Camera2 是唯一可选路径。
? 总结:不要尝试绕过约束强行注入 ImageReader;拥抱 SurfaceTexture + GPU 流水线,是兼顾性能与灵活性的工程最优解。如需进一步降低延迟,可结合 AHardwareBuffer 和 Vulkan(Android 10+)实现零拷贝纹理共享。










