Flutter集成MediaPipe PoseLandmarker：相机覆盖Overlay问题排查

核心原因 #

FlutterFragmentActivity的视图结构和AppCompatActivity存在差异，Flutter的默认视图（SurfaceView/TextureView）会被优先置于上层，导致原生MediaPipe Overlay被相机预览画面遮挡。

具体修复方案 #

1. 强制提升Overlay层级优先级 #

在CameraFragment.kt中，初始化Overlay后直接设置其Z轴层级为最高，确保它能覆盖在相机预览之上：

// 假设你的Overlay实例为poseOverlay
ViewCompat.setZ(poseOverlay, Float.MAX_VALUE)
// 若使用XML布局，也可直接添加属性
// <com.google.mediapipe.solutions.poselandmarker.PoseLandmarkerOverlay
//     ...
//     android:elevation="10dp" />

2. 降低相机预览视图的层级 #

如果调整Overlay无效，反过来降低相机预览View的Z轴层级：

// 获取相机预览的TextureView/SurfaceView实例
val cameraPreview = view.findViewById<TextureView>(R.id.camera_preview)
ViewCompat.setZ(cameraPreview, 0f)

3. 调整Fragment的视图插入容器 #

FlutterFragmentActivity会维护独立的Flutter视图树，原生Fragment的视图可能被插入到Flutter视图的下层。修改MainActivity.kt，将CameraFragment的视图添加到Flutter的顶层容器中：

override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
    super.configureFlutterEngine(flutterEngine)
    val flutterRootView = flutterEngine.views.first()
    val cameraFragment = CameraFragment()
    supportFragmentManager.beginTransaction()
        .add(flutterRootView.id, cameraFragment, "camera_fragment")
        .commit()
}

4. 检查Overlay的绑定逻辑 #

确认CameraFragment.kt中，Overlay是否正确绑定了相机的输入帧流，若绑定时机过晚，也会导致Overlay绘制滞后于相机画面：

// 确保在相机初始化完成后再绑定Overlay
poseLandmarker.setResultListener { result ->
    poseOverlay.setRenderData(result)
    poseOverlay.postInvalidate()
}

关键检查点 #

• 确认Overlay被添加到视图层级的最外层，而非嵌套在相机预览View内部
• 排查FlutterFragmentActivity中是否有自定义的视图层级拦截逻辑
• 验证MediaPipe的Overlay是否开启了硬件加速（默认开启，若关闭会导致绘制异常）

内容的提问来源于stack exchange，提问作者Nitanshu Kumar