Android 判断应用是否处于非全屏模式或fullScreen

Android 判断应用是否处于非全屏模式

对于常见大多数安卓应用判断分屏的方法是使用isInMultiWindowMode()方法来判断是否是处于全屏状态，当这种方法有一种特殊途径会失效，我们先介绍isInMultiWindowMode()方法。在使用另外一种，通过android.app.WindowConfiguration–>getWindowingMode 通过反射的方法调用到这个。

core/java/android/app/WindowConfiguration.java - platform/frameworks/base - Git at Google (googlesource.com)

isInMultiWindowMode() 方法判断分屏

1.使用 Activity 类的 isInMultiWindowMode() 方法来检查当前活动是否在分屏模式下。例如：

javaCopy codeif (isInMultiWindowMode()) {    // 在分屏模式下执行的代码} else {    // 不在分屏模式下执行的代码}

2.如果你需要在应用的其他组件（如 Fragment、Service 等）中检查分屏模式，你可以使用 WindowManager 来获取当前设备的配置信息，并检查 Configuration 中的 isInMultiWindowMode() 方法。例如：

javaCopy codeWindowManager windowManager = (WindowManager) getSystemService(WINDOW_SERVICE);if (windowManager != null) {    Configuration configuration = getResources().getConfiguration();    if (configuration != null && configuration.isInMultiWindowMode()) {        // 在分屏模式下执行的代码    } else {        // 不在分屏模式下执行的代码    }}

这两种方法都可以让你检查应用当前是否处于分屏模式，从而进行相应的操作。

import android.app.Activity;import android.content.res.Configuration;import android.os.Bundle;import android.view.WindowManager;import android.widget.TextView;public class MainActivity extends Activity {    @Override    protected void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        setContentView(R.layout.activity_main);    }        @Override    protected void onResume() {        super.onResume();        // 检查当前是否处于分屏模式        checkMultiWindowMode();    }    @Override    public void onConfigurationChanged(Configuration newConfig) {        super.onConfigurationChanged(newConfig);        // 当配置改变时重新检查分屏模式        checkMultiWindowMode();    }    private void checkMultiWindowMode() {        WindowManager windowManager = (WindowManager) getSystemService(WINDOW_SERVICE);        if (windowManager != null) {            Configuration configuration = getResources().getConfiguration();            if (configuration != null && configuration.isInMultiWindowMode()) {                // 在分屏模式下显示特定布局                setContentView(R.layout.activity_main_multi_window);                TextView textView = findViewById(R.id.textView);                textView.setText("当前处于分屏模式");            } else {                // 不在分屏模式下显示默认布局                setContentView(R.layout.activity_main);            }        }    }}

上面简单的使用了isInMultiWindowMode方法来判断应用是否处于分屏状态。

getWindowingMode方法

    @Override    public void onConfigurationChanged(Configuration newConfig) {        super.onConfigurationChanged(newConfig);        // 当配置改变时重新检查分屏模式        checkWindowingMode(newConfig);    }/** * get the status whether app is shown in full screen or multi windows. * @param  configuration , from activity onConfigurationChanged * */@SuppressLint("PrivateApi")public static void checkWindowingMode(Configuration configuration) {    try {        @SuppressLint("BlockedPrivateApi")        Field field = configuration.getClass().getDeclaredField("windowConfiguration");        field.setAccessible(true);        Class clazz = Class.forName("android.app.WindowConfiguration");        Method method = clazz.getDeclaredMethod("getWindowingMode", null);        method.setAccessible(true);        int windowingMode =  (int) (method.invoke(field.get(configuration)));        isFullScreen = windowingMode == WINDOWING_MODE_FULL_SCREEN;        Log.d(TAG,"windowingMode = "+windowingMode + "isFullScreen "+isFullScreen);    } catch (Exception e) {        e.printStackTrace();        isFullScreen = true;    }}

@SuppressLint("PrivateApi") 是 Android 中的一个注解，用于告诉编译器忽略特定类型的 lint 错误或警告。

使用了私有 API，lint 可能会警告你。你可以在方法前面添加 @SuppressLint("PrivateApi") 注解来消除这个警告。

    @SuppressLint("BlockedPrivateApi")    Field field = configuration.getClass().getDeclaredField("windowConfiguration");    field.setAccessible(true);

使用了反射来获取 windowConfiguration 字段，这个字段可能是一个被标记为私有的 API，因此 lint 可能会对此发出警告。

通过在代码中添加 @SuppressLint("BlockedPrivateApi") 注解，你告诉 lint 忽略这个警告，使得你的代码可以编译通过。

method.setAccessible(true) 是 Java 中反射 API 中的一个方法调用，用于设置方法的可访问性。通过调用 setAccessible(true) 方法，你可以取消对方法的访问限制，使得即使这个方法是私有的或者不可访问的，你也可以在运行时调用它。

int windowingMode =  (int) (method.invoke(field.get(configuration)));

1. field.get(configuration)：首先通过反射获取了名为 “windowConfiguration” 的字段所对应的值，这个值是 configuration 对象中的一个字段的值。
2. method.invoke(field.get(configuration))：然后调用了 method 对象所代表的方法，并传入了上一步获取到的值作为方法调用的对象。这样就相当于在获取到的对象上调用了相应的方法。

我们看一下WindowConfiguration的源码，https://android.googlesource.com/platform/frameworks/base/+/master/core/java/android/app/WindowConfiguration.java

    /** Windowing mode is currently not defined. */    public static final int WINDOWING_MODE_UNDEFINED = 0;    /** Occupies the full area of the screen or the parent container. */    public static final int WINDOWING_MODE_FULLSCREEN = 1;    /** Always on-top (always visible). of other siblings in its parent container. */    public static final int WINDOWING_MODE_PINNED = 2;    /** Can be freely resized within its parent container. */    // TODO: Remove once freeform is migrated to wm-shell.    public static final int WINDOWING_MODE_FREEFORM = 5;    /** Generic multi-window with no presentation attribution from the window manager. */    public static final int WINDOWING_MODE_MULTI_WINDOW = 6;    /** @hide */    @IntDef(prefix = { "WINDOWING_MODE_" }, value = {            WINDOWING_MODE_UNDEFINED,            WINDOWING_MODE_FULLSCREEN,            WINDOWING_MODE_MULTI_WINDOW,            WINDOWING_MODE_PINNED,            WINDOWING_MODE_FREEFORM,    })    public void setWindowingMode(@WindowingMode int windowingMode) {        mWindowingMode = windowingMode;    }    @WindowingMode    public int getWindowingMode() {        return mWindowingMode;    }

NAME	VALE	explain
WINDOWING_MODE_UNDEFINED	0	处理未定义的窗口模式
WINDOWING_MODE_FULLSCREEN	1	处理全屏窗口模式
WINDOWING_MODE_PINNED	2	处理固定窗口模式
WINDOWING_MODE_FREEFORM	5	处理自由窗口模式
WINDOWING_MODE_MULTI_WINDOW	6	处理多窗口模式

通过反射的方式可以拿到全部的窗口模式，通过返回值判断当前是否处于FullScreen状态。