如何在 Android Java 应用中实现真正持久的全屏模式-java教程-PHP中文网

如何在 Android Java 应用中实现真正持久的全屏模式

本文详解如何通过系统 ui 标志组合与窗口标志协同配置，彻底隐藏状态栏、导航栏并防止用户手势唤醒，实现真正沉浸式、不可中断的全屏体验。

本文详解如何通过系统 ui 标志组合与窗口标志协同配置，彻底隐藏状态栏、导航栏并防止用户手势唤醒，实现真正沉浸式、不可中断的全屏体验。

在 Android 开发中，仅调用 FLAG_FULLSCREEN 或设置 SYSTEM_UI_FLAG_FULLSCREEN 并不足以实现“永久全屏”——用户从屏幕顶部下拉或底部上滑时，状态栏（Status Bar）和导航栏（Navigation Bar）仍可能临时显现，破坏沉浸体验。要达到真正持久、抗干扰的全屏效果，需同时满足三个关键条件：窗口级隐藏、系统 UI 标志精准组合、以及生命周期时机正确。

✅ 正确实现步骤（Java）

请将以下代码置于 Activity 的 onCreate() 方法中，严格位于 setContentView() 之前（否则部分标志可能失效）：

@Override
protected void onCreate(Bundle savedInstanceState) {
    // 1. 隐藏标题栏（必须在 setContentView 之前）
    requestWindowFeature(Window.FEATURE_NO_TITLE);

    // 2. 窗口级全屏：移除状态栏占位（关键！）
    getWindow().setFlags(
        WindowManager.LayoutParams.FLAG_FULLSCREEN |
        WindowManager.LayoutParams.FLAG_LAYOUT_NO_LIMITS,
        WindowManager.LayoutParams.FLAG_FULLSCREEN |
        WindowManager.LayoutParams.FLAG_LAYOUT_NO_LIMITS
    );

    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    // 3. 设置 DecorView 的沉浸式系统 UI 标志（推荐 IMMERSIVE_STICKY）
    View decorView = getWindow().getDecorView();
    int uiOptions = 
        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; // “粘性沉浸”：手势触发后自动隐藏

    decorView.setSystemUiVisibility(uiOptions);

    // 4. 【重要】监听系统 UI 变化，防意外唤醒（可选但强烈推荐）
    decorView.setOnSystemUiVisibilityChangeListener(visibility -> {
        if ((visibility & View.SYSTEM_UI_FLAG_FULLSCREEN) == 0) {
            // 状态栏/导航栏被唤醒 → 立即重置
            decorView.setSystemUiVisibility(uiOptions);
        }
    });
}

⚠️ 关键注意事项

执行时机决定成败：getWindow().setFlags(...) 必须在 super.onCreate() 和 setContentView() 之前调用；setSystemUiVisibility() 则必须在 setContentView() 之后（因需获取 DecorView）。
IMMERSIVE_STICKY 是核心：相比普通 IMMERSIVE，它在用户手势触发 UI 显现后会自动重新隐藏（约 3 秒延迟），无需手动监听恢复，大幅提升“持久感”。
避免 SYSTEM_UI_FLAG_LOW_PROFILE：该标志已弃用，且不参与全屏控制。
Android 11+ 行为差异：部分设备厂商（如 Samsung、Xiaomi）可能限制 IMMERSIVE_STICKY 在特定场景下的生效；若需绝对控制（如 Kiosk 模式），应结合 Device Policy API 或启用“数字健康”中的“专注模式”白名单。
横竖屏适配：全屏模式下建议锁定屏幕方向（如 android:screenOrientation="landscape"），避免旋转时 UI 闪烁。