深入理解android 理解SystemUIVisibility

原创

mob649e81563816 2023-10-14 03:52:49 ©著作权

文章标签 UI 导航栏 Android 文章分类 Android 移动开发

©著作权归作者所有：来自51CTO博客作者mob649e81563816的原创作品，请联系作者获取转载授权，否则将追究法律责任

深入理解 Android SystemUIVisibility

介绍

在 Android 中，SystemUI 是指系统界面的一部分，例如状态栏、导航栏等。SystemUIVisibility 是一个标志位，用于控制 SystemUI 的可见性。在本文中，我们将深入探讨 Android 中的 SystemUIVisibility，并通过代码示例来演示其使用。

SystemUIVisibility 的概述

SystemUIVisibility 是一个 32 位的整数，其中每一位代表一个标志位。通过设置不同的标志位，我们可以控制 SystemUI 的可见性。以下是一些常用的标志位：

SYSTEM_UI_FLAG_VISIBLE：SystemUI 可见（默认值）。
SYSTEM_UI_FLAG_LOW_PROFILE：SystemUI 可见，但以低调的方式显示，例如隐藏状态栏上的通知图标。
SYSTEM_UI_FLAG_FULLSCREEN：全屏模式，隐藏状态栏和导航栏。
SYSTEM_UI_FLAG_HIDE_NAVIGATION：隐藏导航栏。
SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN：布局时考虑状态栏，使得布局可以延伸到状态栏下方。
SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION：布局时考虑导航栏，使得布局可以延伸到导航栏下方。

SystemUIVisibility 的使用

我们可以使用 Window 类的 setSystemUiVisibility 方法来设置 SystemUI 的可见性。以下是一个示例代码：

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // 设置全屏模式
        getWindow().getDecorView().setSystemUiVisibility(
            View.SYSTEM_UI_FLAG_FULLSCREEN |
            View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN);
    }
}

在上面的代码中，我们在 onCreate 方法中调用了 setSystemUiVisibility 方法，并传递了 View.SYSTEM_UI_FLAG_FULLSCREEN 和 View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN 两个标志位。这将使得应用进入全屏模式，并且布局将会延伸到状态栏下方。

SystemUIVisibility 的注意事项

在使用 SystemUIVisibility 时，有几点需要注意：

SystemUIVisibility 只对当前的 Activity 有效。当启动新的 Activity 时，需要重新设置 SystemUIVisibility。
SystemUIVisibility 可能会被系统重置，例如当用户从其他应用返回到你的应用时。
SystemUIVisibility 的使用应当遵循用户体验设计的准则，不应过度干扰用户的操作和使用。

关系图

下面是 SystemUIVisibility 的关系图：

erDiagram
    SYSTEM_UI_FLAG_VISIBLE }|..| SystemUIVisibility
    SYSTEM_UI_FLAG_LOW_PROFILE }|..| SystemUIVisibility
    SYSTEM_UI_FLAG_FULLSCREEN }|..| SystemUIVisibility
    SYSTEM_UI_FLAG_HIDE_NAVIGATION }|..| SystemUIVisibility
    SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN }|..| SystemUIVisibility
    SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION }|..| SystemUIVisibility

类图

下面是 SystemUIVisibility 的类图：

classDiagram
    class SystemUIVisibility {
        -int SYSTEM_UI_FLAG_VISIBLE = 0x00000000
        -int SYSTEM_UI_FLAG_LOW_PROFILE = 0x00000001
        -int SYSTEM_UI_FLAG_FULLSCREEN = 0x00000004
        -int SYSTEM_UI_FLAG_HIDE_NAVIGATION = 0x00000002
        -int SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN = 0x00000100
        -int SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION = 0x00000200
        +void setSystemUiVisibility(int visibility)
    }