
android 的 constrainedhighspeedcapturesession 严格限制仅支持预览(surfaceview/surfacetexture)和录制(mediarecorder/mediacodec)两类 surface,imagereader 不被允许;需改用 surfacetexture 配合 opengl 或 gpu 计算实现实时帧分析。
android 的 constrainedhighspeedcapturesession 严格限制仅支持预览(surfaceview/surfacetexture)和录制(mediarecorder/mediacodec)两类 surface,imagereader 不被允许;需改用 surfacetexture 配合 opengl 或 gpu 计算实现实时帧分析。
在使用 CameraConstrainedHighSpeedCaptureSession 进行 120 FPS 高速视频录制时,开发者常期望同时对预览流进行实时、逐帧的图像分析(如运动检测、特征提取或 AI 推理)。然而,正如官方文档明确指出,该会话类型属于“受限高速”模式,其核心设计目标是保障高帧率录制的稳定性与低延迟,因此对输出 Surface 的种类施加了严格约束:
✅ 允许的 Surface 类型仅限:
- 预览 Surface:来自
SurfaceView.getHolder().getSurface()或SurfaceTexture- 录制 Surface:来自
MediaRecorder.getSurface()或MediaCodec.createInputSurface()
❌ImageReader.getSurface()明确不支持 —— 尝试添加将直接触发IllegalArgumentException: Unsupported surface configuration。
这意味着你当前通过 ImageReader.newInstance(...) 创建并注册监听的方案,在 createConstrainedHighSpeedCaptureSession() 流程中必然失败。
✅ 正确路径:使用 SurfaceTexture 实现 GPU 端帧分析
由于预览必须走 SurfaceTexture(尤其配合 AutoFitSurfaceView 时),推荐采用以下高性能架构:
远程控制 Android 设备,支持截图、自动化操作手机 App 等功能。本应用使用 uiautomator2 作为底层框架,通过 ADB 连接设备,用户无需 Root(1)查看手机屏幕;(2)自动化操作手机 App;(3)远程安装/卸载应用……
-
创建 SurfaceTexture 并绑定到 OpenGL 上下文
val textureId = GlUtil.createExternalTexture() val surfaceTexture = SurfaceTexture(textureId) surfaceTexture.setOnFrameAvailableListener { // 新帧到达,触发分析逻辑(务必在 GL 线程调用 updateTexImage()) mGLHandler.post { analyzeFrame(surfaceTexture) } } -
在 OpenGL 线程中处理帧(零拷贝、低延迟)
利用GL_TEXTURE_EXTERNAL_OES纹理类型直接访问 YUV 数据,可结合 OpenGL ES Shader 进行:- 快速色彩空间转换(YUV → RGB)
- 自定义滤镜/边缘检测
- 或通过
glReadPixels+ByteBuffer提取 CPU 可读数据(仅当必需时,注意性能损耗)
-
关键注意事项
- ⚠️ 避免主线程阻塞:
onFrameAvailable回调在 Binder 线程触发,所有耗时操作(含updateTexImage())必须切至专用 GL 线程执行; - ⚠️ 同步控制:
SurfaceTexture.updateTexImage()必须在 GL 线程且有有效上下文时调用,否则抛IllegalStateException; - ⚠️ 帧率匹配:虽然录制为 120 FPS,但
SurfaceTexture的实际帧到达频率取决于预览配置(如你所述为 30 FPS),分析逻辑应适配此节奏,而非强行追赶 120 FPS; - ⚠️ 内存管理:
SurfaceTexture不自动释放纹理资源,务必在onDestroy()中调用release()和detachFromGLContext()。
- ⚠️ 避免主线程阻塞:
? 替代方案评估(不推荐用于高速场景)
-
CameraX +
PreviewView+setAnalyzer():虽易用,但底层不支持 120 FPS 高速模式,无法满足需求; -
ImageReader+ 普通CaptureSession:可实现帧分析,但牺牲高速录制能力,二者不可兼得; -
MediaCodec解码录制文件再分析:属离线处理,违背“实时性”要求。
✅ 总结
在 ConstrainedHighSpeedCaptureSession 场景下,放弃 ImageReader,拥抱 SurfaceTexture + OpenGL 是唯一符合架构约束的实时分析路径。它以少量 GPU 编程成本,换取毫秒级延迟、零内存拷贝和全链路可控性。对于需要 CPU 侧处理的场景,可在 Shader 中完成轻量预处理后,再异步读回 YUV/RGB 数据——始终牢记:高速 ≠ 高负载,合理分流(GPU 前处理 + CPU 后分析)才是工程落地的关键。










