Android VideoView移除Fragment或设为INVISIBLE/GONE时出现异常覆盖层

这个问题本质是VideoView依赖的SurfaceView拥有独立的窗口层级，在组件隐藏、Fragment切换时，Surface的销毁时机和View层级更新不同步，导致短暂露出底层窗口（桌面）或系统绘制的异常过渡画面。以下是几个可行的解决方案：

1. 提前释放VideoView资源 #

在隐藏VideoView或销毁Fragment视图前，主动停止播放并释放资源，确保Surface被及时清理：

// 当需要隐藏VideoView时
videoView.stopPlayback();
videoView.setVisibility(View.GONE);

// Fragment场景下，在视图销毁时处理
@Override
public void onDestroyView() {
    super.onDestroyView();
    if (videoView != null) {
        videoView.stopPlayback();
        videoView = null; // 避免内存泄漏同时确保资源释放
    }
}

2. 替换为TextureView实现视频播放 #

TextureView是普通View的子类，没有独立窗口层，不会出现层级穿透问题。可以配合MediaPlayer实现播放逻辑：

private TextureView mTextureView;
private MediaPlayer mMediaPlayer;

@Override
public void onViewCreated(View view, Bundle savedInstanceState) {
    super.onViewCreated(view, savedInstanceState);
    mTextureView = view.findViewById(R.id.texture_video);
    mTextureView.setSurfaceTextureListener(new TextureView.SurfaceTextureListener() {
        @Override
        public void onSurfaceTextureAvailable(SurfaceTexture surface, int width, int height) {
            initMediaPlayer(surface);
        }

        @Override
        public void onSurfaceTextureSizeChanged(SurfaceTexture surface, int width, int height) {}

        @Override
        public boolean onSurfaceTextureDestroyed(SurfaceTexture surface) {
            releaseMediaPlayer();
            return true;
        }

        @Override
        public void onSurfaceTextureUpdated(SurfaceTexture surface) {}
    });
}

private void initMediaPlayer(SurfaceTexture surface) {
    mMediaPlayer = new MediaPlayer();
    try {
        mMediaPlayer.setDataSource(getContext(), Uri.parse("你的视频路径"));
        mMediaPlayer.setSurface(new Surface(surface));
        mMediaPlayer.setLooping(true);
        mMediaPlayer.prepareAsync();
        mMediaPlayer.setOnPreparedListener(MediaPlayer::start);
    } catch (IOException e) {
        e.printStackTrace();
    }
}

private void releaseMediaPlayer() {
    if (mMediaPlayer != null) {
        mMediaPlayer.stop();
        mMediaPlayer.release();
        mMediaPlayer = null;
    }
}

3. 临时遮罩规避 #

如果暂时不想替换VideoView，可以给VideoView套一层遮罩，在隐藏前先显示遮罩，避免异常画面暴露：

<!-- 布局中给VideoView添加遮罩 -->
<FrameLayout
    android:layout_width="match_parent"
    android:layout_height="match_parent">
    <VideoView
        android:id="@+id/video_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>
    <View
        android:id="@+id/video_mask"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:background="@color/app_background"
        android:visibility="gone"/>
</FrameLayout>

// 隐藏VideoView时先显示遮罩
View maskView = findViewById(R.id.video_mask);
maskView.setVisibility(View.VISIBLE);
videoView.stopPlayback();
videoView.setVisibility(View.GONE);

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