huxq17 / FloatBall

android可拖动，展示菜单，能自动吸边和半隐藏的悬浮球。

FloatBall

效果图

|

Gradle

项目根目录的build.gradle：

buildscript {
   allprojects {
       repositories {
           jcenter()
       }
   }
    dependencies {
        classpath 'com.buyi.huxq17:agencyplugin:1.1.2'
    }
}

App模块的build.gradle：

apply plugin: 'service_agency'

初始化悬浮球配置

 int ballSize = DensityUtil.dip2px(this, 45);
 Drawable ballIcon = BackGroudSeletor.getdrawble("ic_floatball", this);
 FloatBallCfg ballCfg = new FloatBallCfg(ballSize, ballIcon);
 //设置悬浮球的位置
 //FloatBallCfg ballCfg = new FloatBallCfg(ballSize, ballIcon,FloatBallCfg.Gravity.LEFT_CENTER);
 //设置悬浮球不半隐藏
 //ballCfg.setHideHalfLater(false);

生成悬浮球

FloatBallManager是提供操控悬浮球的类，可以通过它来添加菜单，添加点击事件，显示和隐藏悬浮球

显示菜单

初始化悬浮菜单配置

 int menuSize = DensityUtil.dip2px(this, 180);
 int menuItemSize = DensityUtil.dip2px(this, 40);
 FloatMenuCfg menuCfg = new FloatMenuCfg(menuSize, menuItemSize);

生成floatballManger

mFloatballManager = new FloatBallManager(getApplicationContext(), ballCfg, menuCfg);

添加悬浮菜单

addFloatMenuItem();
private void addFloatMenuItem() {
    MenuItem personItem = new MenuItem(BackGroudSeletor.getdrawble("ic_weixin", this)) {
        @Override
        public void action() {
            toast("打开微信");
            mFloatballManager.closeMenu();
        }
    };
    MenuItem walletItem = new MenuItem(BackGroudSeletor.getdrawble("ic_weibo", this)) {
        @Override
        public void action() {
            toast("打开微博");
        }
    };
    MenuItem settingItem = new MenuItem(BackGroudSeletor.getdrawble("ic_email", this)) {
        @Override
        public void action() {
            toast("打开邮箱");
            mFloatballManager.closeMenu();
        }
    };
    mFloatballManager.addMenuItem(personItem)
            .addMenuItem(walletItem)
            .addMenuItem(settingItem)
            .buildMenu();
}

不显示菜单

生成floatballManger

mFloatballManager = new FloatBallManager(getApplicationContext(), ballCfg);

设置悬浮球点击事件

// 如果没有添加菜单，可以设置悬浮球点击事件
if (mFloatballManager.getMenuItemSize() == 0) {
    mFloatballManager.setOnFloatBallClickListener(new FloatBallManager.OnFloatBallClickListener() {
    @Override
        public void onFloatBallClick() {
            toast("点击了悬浮球");
        }
});
}

设置悬浮球所需权限

悬浮球需要判断有没有权限和申请权限这两个功能，这里用的是别人写好的库，可以自己实现。

private void setFloatPermission() {
    //设置悬浮球权限，用于申请悬浮球权限的，这里用的是别人写好的库，可以自己选择
    //如果不设置permission，则不会弹出悬浮球
    mFloatPermissionManager = new FloatPermissionManager();
    mFloatballManager.setPermission(new FloatBallManager.IFloatBallPermission() {
        @Override
        public boolean onRequestFloatBallPermission() {
            requestFloatBallPermission(MainActivity.this);
            return true;
            }

        @Override
        public boolean hasFloatBallPermission(Context context) {
            return mFloatPermissionManager.checkPermission(context);
        }

        @Override
        public void requestFloatBallPermission(Activity activity) {
            mFloatPermissionManager.applyPermission(activity);
        }

    });

记录悬浮球位置并恢复

如果想记录悬浮球位置并在下次打开的时候在上次的位置显示，可参照以下的步骤：

1. 实现LocationService，这里用的SharedPreferences记录位置,你也可以用其他的方式，在类上添加ServiceAgent注解，floatball在需要的时候会找到这个实现类并进行位置记录和恢复的操作。

@ServiceAgent
public class SimpleLocationService implements LocationService {
    private SharedPreferences sharedPreferences;

    @Override
    public void onLocationChanged(int x, int y) {
        SharedPreferences.Editor editor = sharedPreferences.edit();
        editor.putInt("floatball_x", x);
        editor.putInt("floatball_y", y);
        editor.apply();
    }

    @Override
    public int[] onRestoreLocation() {
        //如果坐标点传的是-1，那么就不会恢复位置。
        int[] location = {sharedPreferences.getInt("floatball_x", -1),
                sharedPreferences.getInt("floatball_y", -1)};
        return location;
    }

    @Override
    public void start(Context context) {
        sharedPreferences = context.getSharedPreferences("floatball_location", Context.MODE_PRIVATE);
    }
}

2. 启动LocationService，如果你的实现需要Context的话，可选的。

public class App extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        //在LocationService的实现类里用的是SharedPreferences来记录位置，需要context
        //如果你的实现方式不需要context，则可以不需要这个步骤，可以去掉这行代码
         try {
             ServiceAgency.getService(LocationService.class).start(this);
         }catch (AgencyException e){
            //ignore
         }
    }
}

这里用到了ServiceAgency，如果感兴趣可以点击查看更多。

实现应用内悬浮球

如果想让悬浮球只在应用内打开，可以参考以下代码实现：

private ActivityLifeCycleListener mActivityLifeCycleListener = new ActivityLifeCycleListener();

 //注册Activity生命周期的监听回调
 getApplication().registerActivityLifecycleCallbacks(mActivityLifeCycleListener);

 //注册ActivityLifeCyclelistener以后要记得注销，以防内存泄漏。
 getApplication().unregisterActivityLifecycleCallbacks(mActivityLifeCycleListener);

 public class ActivityLifeCycleListener implements Application.ActivityLifecycleCallbacks {

        @Override
        public void onActivityCreated(Activity activity, Bundle savedInstanceState) {
        }

        @Override
        public void onActivityStarted(Activity activity) {
        }

        @Override
        public void onActivityResumed(Activity activity) {
            ++resumed;
            setFloatballVisible(true);
        }

        @Override
        public void onActivityPaused(Activity activity) {
            --resumed;
            if (!isApplicationInForeground()) {
                setFloatballVisible(false);
            }
        }

        @Override
        public void onActivityStopped(Activity activity) {
        }

        @Override
        public void onActivityDestroyed(Activity activity) {
        }

        @Override
        public void onActivitySaveInstanceState(Activity activity, Bundle outState) {
        }
    }

也可以在Application里实现此功能

悬浮球显示与隐藏

  //显示悬浮球
  mFloatballManager.show();
  //隐藏悬浮球
  mFloatballManager.hide();

更新日志：

2018-11-16：
1.添加悬浮球位置记录和恢复功能。详见 https://github.com/huxq17/FloatBall/issues/16

2018-5-23：
1.解决在小米miui9上悬浮球不显示的问题。

2018-1-18：
1.添加悬浮球仅在单Activity里显示时不需要权限,详见appnopermission模块。

2018-1-16：
1.添加对是否半隐藏悬浮球的设置。

2018-1-13：
1.解决快速点击悬浮球不断的打开和关闭菜单，会高几率的点中菜单的问题，详见 https://github.com/huxq17/FloatBall/issues/10。

2017-12-21：
1.添加设置悬浮球初始显示位置的方法，详见 https://github.com/huxq17/FloatBall/issues/8。

2017-12-16：
1.解决菜单item个数大于3时，菜单item位置会错乱的问题，详见 https://github.com/huxq17/FloatBall/pull/7。

2017-11-16：
1.添加按下返回键关闭悬浮菜单的功能。

2017-11-9：
1.解决android 7.1.1以后悬浮球显示几秒后自动隐藏的问题。

感谢

1. 悬浮球权限适配相关的库

LICENSE

Apache License 2.0