Android沉浸式模式退出后ActionBar仍处于Overlay模式问题求助

嘿，我之前也踩过这个坑！你遇到的核心问题是退出沉浸式模式时，只重置了系统UI标志，但没把ActionBar的Overlay模式关掉，导致它一直保持悬浮状态遮挡内容。下面给你一套完整的解决方案：

1. 先明确进入沉浸式时的正确配置 #

首先确认你进入沉浸式（带ActionBar Overlay）时的代码，通常是这样组合标志的：

// 进入沉浸式+ActionBar Overlay的完整配置
private void enterImmersiveMode() {
    View decorView = getWindow().getDecorView();
    // 设置沉浸式相关的UI标志
    decorView.setSystemUiVisibility(
        View.SYSTEM_UI_FLAG_LAYOUT_STABLE
        | View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION
        | View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
        | View.SYSTEM_UI_FLAG_HIDE_NAVIGATION
        | View.SYSTEM_UI_FLAG_FULLSCREEN
        | View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY
    );
    // 开启ActionBar的Overlay模式，让它悬浮在内容上方
    getSupportActionBar().setOverlayMode(true);
}

2. 退出时的关键重置逻辑 #

退出沉浸式时，必须同时做两件事：重置系统UI标志，以及关闭ActionBar的Overlay模式。这里推荐用View.SYSTEM_UI_FLAG_VISIBLE来完全重置UI状态，而不是只清除部分标志：

private void exitImmersiveMode() {
    View decorView = getWindow().getDecorView();
    // 重置所有沉浸式相关的UI标志，回到默认状态
    decorView.setSystemUiVisibility(View.SYSTEM_UI_FLAG_VISIBLE);
    // 关闭ActionBar的Overlay模式，恢复初始的非悬浮状态
    getSupportActionBar().setOverlayMode(false);
    // 如果你之前隐藏了ActionBar，记得在这里显示回来
    getSupportActionBar().show();
}

3. 整合到你的toggle方法里 #

把上面的逻辑整合到你现有的toggleImmersiveMode方法中，就像这样：

private void toggleImmersiveMode() {
    View decorView = getWindow().getDecorView();
    int currentFlags = decorView.getSystemUiVisibility();
    
    // 判断当前是否处于沉浸式模式
    boolean isImmersive = (currentFlags & View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY) != 0;
    
    if (isImmersive) {
        exitImmersiveMode();
    } else {
        enterImmersiveMode();
    }
}

4. 为什么之前的方法失效？ #

你之前大概率只重置了系统UI标志，但漏掉了getSupportActionBar().setOverlayMode(false)这一步。因为开启Overlay模式是一个独立的ActionBar配置，不会随着系统UI标志的重置自动恢复，必须手动关闭。

另外，你的主题Theme.AppCompat.Light.DarkActionBar默认是不开启Overlay的，所以关闭后就能完美回到初始状态。

针对Android 11+的优化方案 #

如果你的应用适配Android 11及以上版本，推荐用更现代的WindowInsetsControllerAPI，逻辑更清晰：

// 进入沉浸式（Android 11+）
private void enterImmersiveModeApi30() {
    WindowInsetsController insetsController = getWindow().getInsetsController();
    if (insetsController != null) {
        insetsController.hide(WindowInsets.Type.statusBars() | WindowInsets.Type.navigationBars());
        insetsController.setSystemBarsBehavior(WindowInsetsController.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE);
    }
    getSupportActionBar().setOverlayMode(true);
}

// 退出沉浸式（Android 11+）
private void exitImmersiveModeApi30() {
    WindowInsetsController insetsController = getWindow().getInsetsController();
    if (insetsController != null) {
        insetsController.show(WindowInsets.Type.statusBars() | WindowInsets.Type.navigationBars());
        insetsController.setSystemBarsBehavior(WindowInsetsController.BEHAVIOR_DEFAULT);
    }
    getSupportActionBar().setOverlayMode(false);
}

这样调整后，退出沉浸式模式时，ActionBar就会回到初始的非Overlay状态，不会再遮挡你的内容了。

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