Android悬浮窗操作使用总结

1字数 1830阅读 1441

前阵子公司项目中需要大量使用Android悬浮窗去实现一些功能,对公司之前一团糟的代码结构和面对国产Android奇(沙)葩(雕)的机型适配(对,我说的奇(沙)葩(雕)机型就是Vivo)让我不得不去思考一个完整的悬浮窗解决方案。在这个背景下完成了项目任务后,做一个总结,回顾开发的问题和经验总结。

不如首先搞个Demo!体验Demo地址:https://github.com/SunJenry/FloatWindow

image.png

1.添加悬浮窗原理

添加悬浮窗的原理就是获取WindowManager,然后调用WindowManager的 addView(View view, ViewGroup.LayoutParams params)方法即可。View就是需要显示的悬浮窗, ViewGroup.LayoutParams包含了是全屏、非全屏和是否需要拦截触摸事件的参数。 考虑的悬浮窗存在全屏和非全屏、拦截触摸事件和不拦截触摸事件的情况可以两两组合产生4种情况:
1.全屏拦截触摸事件
2.全屏不拦截触摸事件
3.非全屏(wrap_content)拦截触摸事件
4.非全屏(wrap_content)不拦截触摸事件

综合对悬浮窗增加、移除、隐藏、是否可以可键盘交互等等操作可以提出一个基类AbsFloatBase(大家先粗略建立一个映像,下面的文章会针对具体的方法做详细解释):

public abstract class AbsFloatBase {

    public static final String TAG = "AbsFloatBase";

    static final int FULLSCREEN_TOUCHABLE = 1;
    static final int FULLSCREEN_NOT_TOUCHABLE = 2;
    static final int WRAP_CONTENT_TOUCHABLE = 3;
    static final int WRAP_CONTENT_NOT_TOUCHABLE = 4;

    WindowManager.LayoutParams mLayoutParams;

    View mInflate;
    Context mContext;
    WindowManager mWindowManager;
    private boolean mAdded;
    //设置隐藏时是否是INVISIBLE
    private boolean mInvisibleNeed = false;
    private boolean mRequestFocus = false;
    int mGravity = Gravity.CENTER_HORIZONTAL | Gravity.CENTER_VERTICAL;
    int mViewMode = WRAP_CONTENT_NOT_TOUCHABLE;
    Handler mHandler = new Handler(Looper.getMainLooper());

    public AbsFloatBase(Context context) {
        mContext = context;

        create();
    }

    /**
     * 设置隐藏View的方式是否为Invisible,默认为Gone
     *
     * @param invisibleNeed 是否是Invisible
     */
    public void setInvisibleNeed(boolean invisibleNeed) {
        mInvisibleNeed = invisibleNeed;
    }

    /**
     * 悬浮窗是否需要获取焦点,通常获取焦点后,悬浮窗可以和软键盘发生交互,被覆盖的应用失去焦点。
     * 例如:游戏将失去背景音乐
     *
     * @param requestFocus
     */
    public void requestFocus(boolean requestFocus) {
        mRequestFocus = requestFocus;
    }

    @CallSuper
    public void create() {
        mWindowManager = (WindowManager) mContext.getApplicationContext().getSystemService(WINDOW_SERVICE);
    }

    @CallSuper
    public synchronized void show() {
        if (mInflate == null)
            throw new IllegalStateException("FloatView can not be null");

        if (mAdded) {
            mInflate.setVisibility(View.VISIBLE);
            return;
        }

        getLayoutParam(mViewMode);

        mInflate.setVisibility(View.VISIBLE);

        try {
            mWindowManager.addView(mInflate, mLayoutParams);
            mAdded = true;
        } catch (Exception e) {
            Log.e(TAG, "添加悬浮窗失败!!!!!!");
           Toast.makeText(mContext, "添加悬浮窗失败!!!!!!请检查悬浮窗权限", Toast.LENGTH_SHORT).show();
        }
    }

    @CallSuper
    public void hide() {
        if (mInflate != null) {
            mInflate.setVisibility(View.INVISIBLE);
        }
    }

    @CallSuper
    public void gone() {
        if (mInflate != null) {
            mInflate.setVisibility(View.GONE);
        }
    }

    @CallSuper
    public void remove() {
        if (mInflate != null && mWindowManager != null) {
            if (mInflate.isAttachedToWindow()) {
                mWindowManager.removeView(mInflate);
            }
            mAdded = false;
        }

        if (mHandler != null) {
            mHandler.removeCallbacksAndMessages(null);
        }
    }

    @CallSuper
    protected View inflate(@LayoutRes int layout) {
        mInflate = View.inflate(mContext, layout, null);
        return mInflate;
    }

    @SuppressWarnings("unchecked")
    protected <T extends View> T findView(@IdRes int id) {
        if (mInflate != null) {
            return (T) mInflate.findViewById(id);
        }
        return null;
    }


    /**
     * 获取悬浮窗LayoutParam
     *
     * @param mode
     */
    protected void getLayoutParam(int mode) {
        switch (mode) {
            case FULLSCREEN_TOUCHABLE:
                mLayoutParams = FloatWindowParamManager.getFloatLayoutParam(true, true);
                break;

            case FULLSCREEN_NOT_TOUCHABLE:
                mLayoutParams = FloatWindowParamManager.getFloatLayoutParam(true, false);
                break;

            case WRAP_CONTENT_NOT_TOUCHABLE:
                mLayoutParams = FloatWindowParamManager.getFloatLayoutParam(false, false);
                break;

            case WRAP_CONTENT_TOUCHABLE:
                mLayoutParams = FloatWindowParamManager.getFloatLayoutParam(false, true);
                break;
        }

        if (mRequestFocus) {
            mLayoutParams.flags = mLayoutParams.flags & ~WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE;
        }

        mLayoutParams.gravity = mGravity;
    }

    /**
     * 获取可见性
     *
     * @return
     */
    public boolean getVisibility() {
        if (mInflate != null && mInflate.getVisibility() == View.VISIBLE) {
            return true;
        } else {
            return false;
        }
    }

    /**
     * 改变可见性
     */
    public void toggleVisibility() {
        if (mInflate != null) {
            if (getVisibility()) {
                if (mInvisibleNeed) {
                    hide();
                } else {
                    gone();
                }
            } else {
                show();
            }
        }
    }
}

2.ABSFloatBase使用

这里建议下载上面提供的Demo结合会更方便理解。那么通过继承ABSFloatBase实现一个简单悬浮窗吧。以下图悬浮窗为例:

image.png

具体代码如下:

public class FloatPermissionDetectView extends AbsFloatBase {

    public FloatPermissionDetectView(Context context) {
        super(context);
    }

    @Override
    public void create() {
        super.create();

        mViewMode = WRAP_CONTENT_TOUCHABLE;
        mGravity = Gravity.CENTER_VERTICAL | Gravity.CENTER_HORIZONTAL;

        inflate(R.layout.main_layout_float_permission_detect);

        findView(R.id.btn_close).setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                remove();
            }
        });
    }
}

在需要显示的地方调用:

 mFloatPermissionDetectView = new FloatPermissionDetectView(getApplicationContext());
 mFloatPermissionDetectView.show();

即可。怎么样,简单吧。先对这里面的代码做个简单的解释:
1.首先重载create(),在这里设置自定义布局,对应的代码就是:inflate(R.layout.main_layout_float_permission_detect);
2.mViewMode = WRAP_CONTENT_TOUCHABLE;用来设置当前悬浮窗是wrap_content并且拦截触摸事件的,与之相对应的还有FULLSCREEN_TOUCHABLEFULLSCREEN_NOT_TOUCHABLEWRAP_CONTENT_NOT_TOUCHABLE,看名字就理解这些参数是什么作用,我就不一一解释了。
3.mGravity = Gravity.CENTER_VERTICAL | Gravity.CENTER_HORIZONTAL;当悬浮窗是非全屏类型的,可以设置悬浮窗是展示在屏幕的上下左右、还是中间。其他的类型大家可以自行探索。这里面基类中默认就是居中类型的,所以这里相当于没有设置。(为什么相当于没有设置我还写?因为我想展示一下操作。)

image.png

4.调用findView(int id)方法找到布局中的控件id,这部分和Activity中一样,就不详细解释了。至于获取到控件之后嘛,当然是嘿嘿嘿咯。比如上面点击之后调用remove()方法移除悬浮窗。
5.在需要的地方new一个对象,调用show()方法,即可展示悬浮窗。

其他几种类型可以自行去感受下,在不拦截触摸事件的类型中,悬浮窗下面的控件是可以接收到触摸事件的。

3.和输入法交互

image.png
image.png

按上面的方法写出来的悬浮窗是无法呼出输入法的,这是因为WindowManager的 addView(View view, ViewGroup.LayoutParams params)ViewGroup.LayoutParams params设置了WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE,这个Flag不会影响被覆盖应用的行为,如果需要在悬浮窗中呼出输入法就需要去除这个Flag,这时就需要调用基类的requestFocus(true);方法。和Demo中相对应的就是InputWindow,具体代码如下:

public class InputWindow extends AbsFloatBase {
    public InputWindow(Context context) {
        super(context);
    }

    @Override
    public void create() {
        super.create();

        mViewMode = WRAP_CONTENT_TOUCHABLE;

        inflate(R.layout.main_layout_input_window);

        requestFocus(true);

        findView(R.id.btn_close).setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                remove();
            }
        });
    }
}

调用requestFocus(true);这个方法会发生什么呢?除了可以呼出键盘外,被覆盖的应用失去焦点,就不能再处理输入事件,比如如果覆盖在游戏上,游戏会暂停背景音乐。

4.关于悬浮窗权限

如果你安装完应用直接点击后几个按钮想要添加悬浮窗的话,会发现没有添加任何悬浮窗,而且会得到Toast报错。(Vivo手机除外哈,具体原因稍候解释)

image.png

这是因为添加悬浮窗需要悬浮窗权限,准确的讲就是允许显示在其他应用的上层的权限。

image.png

如果没有获取该权限,点击检查悬浮窗权限就会弹出跳转该页面的悬浮窗,确定后就会跳转到该页面。当然在国内魔改ROM的悲惨状况下,这个页面被以各种形式展现到各个地方:

小米MIUI.png
Vivo.png

还有各种各样的样式我就不一一例举了。至于跳转到这个页面的方法也是各不相同,好在Demo里面已经处理了大部分机型了,根据目前公司的反馈,已经可以处理相当多的机型了。考虑到百万级的安装量,和几十款测试机型,勉强凑合用吧,实在不行就只能自行手动打开了。对不起,在国产ROM面前,我,败了。


image.png

那么怎么检查应用是否有允许显示在其他应用的上层的权限呢?Demo中提供的FloatWindowParamManager.checkPermission(getApplicationContext());方法就可以了。当然如果事情是这样,那么世界该是多么美好!然鹅,在Vivo面前,我,又败了!

image.png

对于大部分机型而言,这个方法算得上是一个不错的解决方案,但是遇到Vivo这样的奇(沙)葩(雕),会遇到一些难言的困惑。比如在Vivo手机上,当你点击Button检查权限时,FloatWindowParamManager.checkPermission(getApplicationContext());一直返回true,但是当应用处于后台时,试图添加悬浮窗又会失败!已经添加的悬浮窗会消失!经过一番令人惊奇的操作后发现,原来Vivo在应用前台可见时会默认给予应用这个权限(实际这个悬浮窗权限开关没有打开也行),但是当应用处于后台时只有这个悬浮穿权限开关真的打开时才能添加显示悬浮窗!所以,只有真的打开了悬浮窗权限开关才算是达到了我们的目的!!! 这么说有点绕脖子,但是我相信你是懂我的!

image.png

所以,对于Vivo的操作就显得非常特别,重点在于确保App处于后台时确实获取到了悬浮窗权限!具体到Demo里面的代码体现在:

    private Handler mHandler = new Handler(Looper.getMainLooper()) {
        @Override
        public void handleMessage(Message msg) {
            int what = msg.what;
            switch (what) {
                case HANDLER_DETECT_PERMISSION:
                    if (FloatWindowParamManager.checkPermission(getApplicationContext())) {
                        //对沙雕VIVO机型特殊处理,应用处于后台检查悬浮窗权限成功才能确认真的获取了悬浮窗权限
                        if (RomUtils.isVivoRom() && AppUtils.isAppForeground()) {
                            Log.e(TAG, "悬浮窗权限检查成功,但App处于前台状态,特殊机型会允许App获取权限,特殊机型就是指Vivo这个沙雕");
                            mHandler.sendEmptyMessageDelayed(HANDLER_DETECT_PERMISSION, 500);
                            return;
                        }

                        mHandler.removeMessages(HANDLER_DETECT_PERMISSION);
                        Log.e(TAG, "悬浮窗权限检查成功");
                        showFloatPermissionWindow();
                    } else {
                        Log.e(TAG, "悬浮窗权限检查失败");
                        mHandler.sendEmptyMessageDelayed(HANDLER_DETECT_PERMISSION, 500);
                    }
                    break;
            }
        }
    };

至于为什么要用Handler不停地循环检查,这是为了在打开权限后可以立刻显示悬浮窗,具体效果看Demo就知道了。不过部分机型在打开悬浮窗开关的时候并不能立刻显示悬浮窗,只有刷新页面,比如点击返回的时候才能显示。哎,我再次认输辽。如果哪位大佬有解决方案,可以教一下我。

2019年2月20号新增9.0下悬浮窗不能进入刘海区域的解决办法:

//刘海屏延伸到刘海里面
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
                layoutParams.layoutInDisplayCutoutMode = WindowManager.LayoutParams.LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES;
            }

如果不需要悬浮窗延伸到刘海里面去除这几行代码即可。
PS:华为Mate20刘海区域触控无效,所以需要在该区域有触控控件的需要避开刘海区域。

推荐阅读更多精彩内容