【亲测免费】 EasyFloat： Android悬浮窗框架使用指南

1. 项目介绍

EasyFloat 是一个Android平台的轻量级悬浮窗口库，旨在简化悬浮窗的开发流程。它提供了拖拽、自定义动画、页面过滤以及多种显示模式等功能。EasyFloat不仅支持单页面浮窗（无需特殊权限），还支持全局浮窗和应用前台浮窗（需要悬浮窗权限）。此外，库内集成了自动权限检测和处理，使得开发者可以更方便地管理和控制浮窗。

2. 项目快速启动

添加依赖

在项目根目录的 build.gradle 文件中添加 JitPack 仓库：

allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}

然后，在你的应用模块的 build.gradle 文件中引入 EasyFloat 库：

dependencies {
    implementation 'com.github.princekin-f:EasyFloat:2.0.4'
}

同步Gradle后，即可使用 EasyFloat。

显示浮窗

使用以下代码在你的Activity或Fragment中展示一个简单的浮窗：

// 创建一个EasyFloat实例
EasyFloat.with(this)
    // 设置浮窗布局资源ID
    .setLayout(R.layout.float_test)
    // 显示浮窗
    .show();

处理权限

如果您需要使用全局浮窗或应用前台浮窗，记得在 AndroidManifest.xml 中声明悬浮窗权限：

<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW"/>

3. 应用案例和最佳实践

案例一：自定义拖动边界

EasyFloat.with(this)
    .setLayout(R.layout.float_test)
    .setDragEdge(EasyFloat.DragEdge.ALL) // 允许四周拖动
    .setEdgeDragWidth(100) // 边缘宽度限制
    .show();

最佳实践：状态回调与动画效果

EasyFloat.with(this)
    .setLayout(R.layout.float_test)
    .setOnStatusChangeListener(new OnStatusChangeListener() {
        @Override
        public void onStatusChange(int status) {
            // 根据status值处理不同状态
        }
    })
    .setInAnim(R.anim.slide_in_right) // 进入动画
    .setOutAnim(R.anim.slide_out_left) // 退出动画
    .show();

4. 典型生态项目

EasyFloat 被广泛应用于各种需要悬浮窗口功能的应用中，例如：

• 悬浮工具箱应用，提供快捷操作入口
• 录音或屏幕录制应用，显示浮动控件
• 游戏辅助应用，提供游戏内的辅助功能

通过 EasyFloat 的高度定制性和易用性，开发者能够快速集成这类功能，提升用户体验。

---

本文档介绍了如何开始使用 EasyFloat，并展示了基础的配置和高级应用场景。希望对您在开发过程中使用悬浮窗口有所帮助。如需更多详情和示例，建议查阅项目官方文档或GitHub上的示例代码。