使用 Android 的 View#setSystemUiVisibility 方法改变状态栏和导航栏状态

2023-08-18 06:21:09

通过 View#setSystemUiVisibility 掌控 Android 状态栏和导航栏

介绍

在 Android 应用程序中，状态栏和导航栏是两个至关重要的元素，它们提供了用户交互和设备控制的重要信息。不过，有时候您可能需要自定义这些元素的外观和行为，以适应您的应用程序的特定需求。这就是 View#setSystemUiVisibility 方法派上用场的地方。本文将深入探讨如何使用此方法更改状态栏和导航栏的状态，以及如何保持这些更改持久有效。

更改状态栏和导航栏的状态

View#setSystemUiVisibility 方法接受一个标志值作为参数，用于指定要更改的状态。这些标志包括：

View.SYSTEM_UI_FLAG_FULLSCREEN：隐藏状态栏和导航栏，让您的应用程序全屏显示。
View.SYSTEM_UI_FLAG_HIDE_NAVIGATION：隐藏导航栏，但保留状态栏。
View.SYSTEM_UI_FLAG_IMMERSIVE：隐藏状态栏和导航栏，并在用户与屏幕交互时暂时显示它们。
View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY：与 SYSTEM_UI_FLAG_IMMERSIVE 类似，但在用户交互后始终显示状态栏和导航栏，直到再次交互为止。

您可以组合多个标志来创建自定义状态和导航栏配置。例如，以下代码将隐藏状态栏和导航栏，并在用户与屏幕交互时暂时显示它们：

View decorView = getWindow().getDecorView();
decorView.setSystemUiVisibility(View.SYSTEM_UI_FLAG_FULLSCREEN | View.SYSTEM_UI_FLAG_IMMERSIVE);

保持状态栏和导航栏更改

使用 View#setSystemUiVisibility 方法更改状态栏或导航栏的状态时，这些更改仅在当前活动期间有效。当您离开活动并重新进入时，状态栏和导航栏将恢复到其默认状态。

要保持状态栏和导航栏更改，您需要在 onResume() 或 onWindowFocusChanged() 方法中重新设置它们。这两个方法会在每次用户与活动交互时被调用。

以下代码示例演示了如何在 onResume() 方法中重新设置状态栏和导航栏更改：

@Override
protected void onResume() {
    super.onResume();
    
    View decorView = getWindow().getDecorView();
    decorView.setSystemUiVisibility(View.SYSTEM_UI_FLAG_FULLSCREEN | View.SYSTEM_UI_FLAG_IMMERSIVE);
}

示例：创建一个全屏游戏应用程序

让我们通过一个示例来说明 View#setSystemUiVisibility 方法的实际应用。想象一下，您正在开发一款游戏应用程序，需要全屏模式以提供更好的沉浸感。您可以使用以下代码实现此功能：

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // 设置为全屏模式
    View decorView = getWindow().getDecorView();
    decorView.setSystemUiVisibility(View.SYSTEM_UI_FLAG_FULLSCREEN);
    
    // 设置内容视图
    setContentView(R.layout.activity_game);
}

在 onResume() 方法中，您还需要重新设置全屏模式，以防设备方向发生变化或应用程序暂停后恢复。

@Override
protected void onResume() {
    super.onResume();
    
    View decorView = getWindow().getDecorView();
    decorView.setSystemUiVisibility(View.SYSTEM_UI_FLAG_FULLSCREEN);
}

常见问题解答