SurfaceView显示相机预览时TextView无法叠加显示的问题求助

这个问题的核心原因是SurfaceView的特殊渲染机制：它拥有独立的绘图表面，默认层级会高于普通View（比如TextView）。你在代码里是动态把SurfaceView添加到FrameLayout中的，而FrameLayout的子View展示顺序是“后添加的在上方”——XML里的TextView先存在，之后代码添加的SurfaceView自然就把它盖住了。

下面给你两种可行的解决方案：

方案一：快速调整View层级（最小代码改动） #

只需要在添加完SurfaceView后，把TextView移到最上层即可，用bringToFront()方法就能实现：

修改你的setupPreviewDisplayView()方法：

private void setupPreviewDisplayView() {
    previewDisplayView.setVisibility(View.GONE);
    ViewGroup viewGroup = findViewById(R.id.preview_display_layout);
    viewGroup.addView(previewDisplayView);
    gestureView = (TextView) findViewById(R.id.gestureView);
    
    // 关键：把TextView移到SurfaceView上方
    gestureView.bringToFront();
    
    previewDisplayView
            .getHolder()
            .addCallback(
                    new SurfaceHolder.Callback() {
                        @Override
                        public void surfaceCreated(SurfaceHolder holder) {
                            processor.getVideoSurfaceOutput().setSurface(holder.getSurface());
                        }

                        @Override
                        public void surfaceChanged(SurfaceHolder holder, int format, int width, int height) {
                            Size viewSize = new Size(width, height);
                            Size displaySize = cameraHelper.computeDisplaySizeFromViewSize(viewSize);
                            converter.setSurfaceTextureAndAttachToGLContext(previewFrameTexture, displaySize.getWidth(), displaySize.getHeight());
                        }

                        @Override
                        public void surfaceDestroyed(SurfaceHolder holder) {
                            processor.getVideoSurfaceOutput().setSurface(null);
                        }
                    });
}

另外建议给TextView设置白色文字（android:textColor="#ffffff"），不然黑色文字在相机预览上可能几乎看不见。

方案二：改用TextureView（更优雅的长期方案） #

如果想彻底避免SurfaceView的层级问题，可以换成TextureView——它是普通View的子类，和TextView处于同一渲染层级，布局逻辑更直观。

第一步：修改布局XML #

把动态创建的SurfaceView换成XML里的TextureView，直接放在TextView下方：

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent">
    <FrameLayout
        android:id="@+id/preview_display_layout"
        android:layout_width="match_parent"
        android:layout_height="match_parent">
        <TextureView
            android:id="@+id/previewDisplayView"
            android:layout_width="match_parent"
            android:layout_height="match_parent"/>
        <TextView
            android:id="@+id/gestureView"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:layout_marginTop="80dp"
            android:gravity="center"
            android:text="hello"
            android:textColor="#ffffff"
            android:textSize="24sp"/>
    </FrameLayout>
</androidx.constraintlayout.widget.ConstraintLayout>

第二步：修改Activity代码 #

替换SurfaceView相关逻辑为TextureView的SurfaceTextureListener：

public class MainActivity extends AppCompatActivity {
    private static final boolean FLIP_FRAMES_VERTICALLY = true;
    private SurfaceTexture previewFrameTexture;
    private TextureView previewDisplayView; // 改为TextureView
    private EglManager eglManager;
    private TextView gestureView;
    private CameraXPreviewHelper cameraHelper;
    private static final int CAMERA_FACING = CameraSelector.LENS_FACING_BACK; // 根据你的需求调整

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        previewDisplayView = findViewById(R.id.previewDisplayView); // 直接从XML获取
        setupPreviewDisplayView();
        startCamera(); // 记得调用启动相机的方法
    }

    private void setupPreviewDisplayView() {
        previewDisplayView.setVisibility(View.GONE);
        gestureView = findViewById(R.id.gestureView);
        
        // 用TextureView的SurfaceTextureListener替代SurfaceHolder.Callback
        previewDisplayView.setSurfaceTextureListener(new TextureView.SurfaceTextureListener() {
            @Override
            public void onSurfaceTextureAvailable(SurfaceTexture surface, int width, int height) {
                // 把Surface传给处理器
                processor.getVideoSurfaceOutput().setSurface(new Surface(surface));
            }

            @Override
            public void onSurfaceTextureSizeChanged(SurfaceTexture surface, int width, int height) {
                Size viewSize = new Size(width, height);
                Size displaySize = cameraHelper.computeDisplaySizeFromViewSize(viewSize);
                converter.setSurfaceTextureAndAttachToGLContext(previewFrameTexture, displaySize.getWidth(), displaySize.getHeight());
            }

            @Override
            public boolean onSurfaceTextureDestroyed(SurfaceTexture surface) {
                processor.getVideoSurfaceOutput().setSurface(null);
                return true; // 返回true表示我们自行处理SurfaceTexture的释放
            }

            @Override
            public void onSurfaceTextureUpdated(SurfaceTexture surface) {
                // 可选：预览帧更新时的回调，不需要可以留空
            }
        });
    }

    private void startCamera() {
        cameraHelper = new CameraXPreviewHelper();
        cameraHelper.setOnCameraStartedListener(
                surfaceTexture -> {
                    previewFrameTexture = surfaceTexture;
                    previewDisplayView.setVisibility(View.VISIBLE);
                    // 将相机输出的SurfaceTexture绑定到TextureView
                    previewDisplayView.setSurfaceTexture(surfaceTexture);
                });
        cameraHelper.startCamera(this, CAMERA_FACING, null);
    }
}

两种方案对比：

• 方案一适合快速修复问题，代码改动极小；
• 方案二更适合长期维护，布局逻辑更清晰，没有SurfaceView的层级陷阱，只是性能比SurfaceView略低（绝大多数场景下可以忽略）。

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