EasyFloat实战案例：从零构建完整的悬浮窗应用

EasyFloat实战案例从零构建完整的悬浮窗应用【免费下载链接】EasyFloat EasyFloat浮窗从未如此简单Android可拖拽悬浮窗口支持页面过滤、自定义动画可设置单页面浮窗、前台浮窗、全局浮窗浮窗权限按需自动申请...项目地址: https://gitcode.com/gh_mirrors/ea/EasyFloatAndroid悬浮窗开发从未如此简单EasyFloat是一个功能强大、易于使用的Android悬浮窗框架支持页面过滤、自定义动画、拖拽吸附等丰富功能。本文将带你从零开始通过实战案例全面掌握EasyFloat悬浮窗框架的核心功能和应用场景。一、EasyFloat框架简介与核心优势EasyFloat是专为Android开发者设计的悬浮窗解决方案它解决了传统悬浮窗开发中的权限管理、生命周期控制、拖拽交互等复杂问题。该框架支持单页面浮窗、前台浮窗和全局浮窗三种显示模式能够满足不同业务场景的需求。核心功能特性零配置启动无需初始化一行代码即可创建悬浮窗️智能权限管理自动检测和申请悬浮窗权限灵活的显示模式支持Activity内、前台和全局显示丰富的动画效果内置默认动画支持自定义动画策略智能拖拽吸附15种吸附模式支持边界限制高度可定制支持自定义布局、事件回调、状态监听二、项目集成与环境搭建2.1 添加依赖配置首先在项目的根目录build.gradle文件中添加JitPack仓库allprojects { repositories { maven { url https://jitpack.io } } }然后在应用模块的build.gradle中添加EasyFloat依赖dependencies { implementation com.github.princekin-f:EasyFloat:2.0.4 }2.2 权限声明配置根据使用场景在AndroidManifest.xml中添加相应权限!-- 使用系统浮窗时需要此权限 -- uses-permission android:nameandroid.permission.SYSTEM_ALERT_WINDOW /三、基础悬浮窗创建实战3.1 最简单的悬浮窗实现创建基础悬浮窗只需一行代码// 创建并显示一个简单的悬浮窗 EasyFloat.with(this) .setLayout(R.layout.float_app) .show()图EasyFloat支持多种悬浮窗类型和完整的生命周期回调管理3.2 完整配置的悬浮窗示例下面是一个包含完整配置的悬浮窗实现EasyFloat.with(this) .setLayout(R.layout.float_app) { view - // 初始化视图组件 view.findViewByIdImageView(R.id.ivClose).setOnClickListener { EasyFloat.dismiss() } view.findViewByIdTextView(R.id.tvContent).text 欢迎使用EasyFloat } .setShowPattern(ShowPattern.ALL_TIME) // 全局显示 .setSidePattern(SidePattern.RESULT_HORIZONTAL) // 水平吸附 .setTag(main_float) // 设置标签用于区分多个浮窗 .setDragEnable(true) // 启用拖拽 .setGravity(Gravity.END or Gravity.CENTER_VERTICAL, 0, 200) // 初始位置 .setBorder(100, 100, 800, 800) // 设置拖拽边界 .registerCallback { createResult { isCreated, msg, _ - Toast.makeText(thisMainActivity, 悬浮窗创建${if(isCreated) 成功 else 失败}: $msg, Toast.LENGTH_SHORT).show() } show { Log.d(EasyFloat, 悬浮窗显示) } hide { Log.d(EasyFloat, 悬浮窗隐藏) } dismiss { Log.d(EasyFloat, 悬浮窗关闭) } drag { view, motionEvent - // 拖拽过程中的处理 view.findViewByIdTextView(R.id.tvContent).text 拖拽中... } dragEnd { // 拖拽结束处理 it.findViewByIdTextView(R.id.tvContent).text 拖拽结束 } } .show()四、高级功能实战应用4.1 多悬浮窗管理策略在实际应用中我们经常需要管理多个悬浮窗。EasyFloat通过标签系统完美支持这一需求// 创建第一个悬浮窗 EasyFloat.with(this) .setLayout(R.layout.float_notification) .setTag(notification_float) .setShowPattern(ShowPattern.ALL_TIME) .show() // 创建第二个悬浮窗 EasyFloat.with(this) .setLayout(R.layout.float_quick_action) .setTag(quick_action_float) .setShowPattern(ShowPattern.FOREGROUND) .setLocation(100, 100) .show() // 单独控制特定悬浮窗 EasyFloat.hide(notification_float) // 隐藏通知悬浮窗 EasyFloat.show(quick_action_float) // 显示快捷操作悬浮窗 EasyFloat.dismiss(notification_float) // 关闭通知悬浮窗4.2 页面过滤与智能显示EasyFloat支持页面过滤功能可以在特定页面自动隐藏悬浮窗EasyFloat.with(applicationContext) .setLayout(R.layout.float_global) .setShowPattern(ShowPattern.ALL_TIME) .setFilter(MainActivity::class.java, LoginActivity::class.java) // 在这些页面不显示 .setTag(global_float) .show()4.3 拖拽吸附与边界限制图EasyFloat支持拖拽边界限制和吸附效果提升用户体验// 设置拖拽边界和吸附效果 EasyFloat.with(this) .setLayout(R.layout.float_draggable) .setDragEnable(true) .setSidePattern(SidePattern.RESULT_SIDE) // 侧边吸附 .setBorder(50, 50, 500, 800) // 设置拖拽边界左、上、右、下 .registerCallback { drag { view, motionEvent - // 实现拖拽关闭功能 DragUtils.registerDragClose(motionEvent, object : OnTouchRangeListener { override fun touchInRange(inRange: Boolean, view: BaseSwitchView) { // 拖拽到删除区域时的反馈 if (inRange) { view.findViewByIdTextView(R.id.tvDelete).text 松手删除 view.findViewByIdImageView(R.id.ivDelete) .setImageResource(R.drawable.icon_delete_selected) } } override fun touchUpInRange() { // 在删除区域松手时关闭悬浮窗 EasyFloat.dismiss() } }) } } .show()4.4 自定义动画与交互效果EasyFloat支持自定义入场和出场动画// 使用自定义动画 EasyFloat.with(this) .setLayout(R.layout.float_animated) .setAnimator(object : OnFloatAnimator { override fun enterAnim(view: View, parent: ViewGroup): Animator { // 自定义入场动画 return ObjectAnimator.ofFloat(view, alpha, 0f, 1f).apply { duration 300 } } override fun exitAnim(view: View, parent: ViewGroup): Animator { // 自定义出场动画 return ObjectAnimator.ofFloat(view, translationY, 0f, 100f).apply { duration 200 } } }) .show() // 或者使用内置的默认动画 .setAnimator(DefaultAnimator())五、实际应用场景案例5.1 音乐播放器悬浮控制面板class MusicPlayerFloat { companion object { private const val TAG music_player_float fun show(context: Context, musicInfo: MusicInfo) { EasyFloat.with(context) .setLayout(R.layout.float_music_player) { view - val ivCover view.findViewByIdImageView(R.id.ivCover) val tvTitle view.findViewByIdTextView(R.id.tvTitle) val tvArtist view.findViewByIdTextView(R.id.tvArtist) val btnPlay view.findViewByIdImageButton(R.id.btnPlay) val btnNext view.findViewByIdImageButton(R.id.btnNext) val btnPrev view.findViewByIdImageButton(R.id.btnPrev) // 加载音乐信息 Glide.with(context).load(musicInfo.coverUrl).into(ivCover) tvTitle.text musicInfo.title tvArtist.text musicInfo.artist // 设置播放控制 btnPlay.setOnClickListener { // 播放/暂停逻辑 MusicPlayer.togglePlay() updatePlayButton(btnPlay) } btnNext.setOnClickListener { MusicPlayer.next() } btnPrev.setOnClickListener { MusicPlayer.previous() } } .setTag(TAG) .setShowPattern(ShowPattern.ALL_TIME) .setDragEnable(true) .setSidePattern(SidePattern.RESULT_HORIZONTAL) .setGravity(Gravity.END or Gravity.BOTTOM, 20, 20) .registerCallback { dragEnd { // 拖拽结束后自动吸附到边缘 it.animate().translationX(0f).setDuration(200).start() } } .show() } fun hide() EasyFloat.hide(TAG) fun dismiss() EasyFloat.dismiss(TAG) } }5.2 全局快捷操作悬浮按钮class QuickActionFloat { companion object { private const val TAG quick_action_float fun init(context: Context) { EasyFloat.with(context.applicationContext) .setLayout(R.layout.float_quick_actions) { view - val btnScreenshot view.findViewByIdButton(R.id.btnScreenshot) val btnRecord view.findViewByIdButton(R.id.btnRecord) val btnNote view.findViewByIdButton(R.id.btnNote) val btnCalculator view.findViewByIdButton(R.id.btnCalculator) btnScreenshot.setOnClickListener { takeScreenshot() } btnRecord.setOnClickListener { startRecording() } btnNote.setOnClickListener { openQuickNote() } btnCalculator.setOnClickListener { showCalculator() } } .setTag(TAG) .setShowPattern(ShowPattern.FOREGROUND) .setDragEnable(true) .setSidePattern(SidePattern.RESULT_VERTICAL) .setLocation(20, 200) .setFilter(SettingsActivity::class.java) // 在设置页面不显示 .registerCallback { createResult { isCreated, msg, _ - if (!isCreated) { Log.e(QuickActionFloat, 创建失败: $msg) } } } .show() } fun toggle() { if (EasyFloat.isShow(TAG)) { EasyFloat.hide(TAG) } else { EasyFloat.show(TAG) } } } }5.3 聊天应用悬浮窗实现class ChatHeadFloat(private val context: Context) { private val TAG chat_head_${System.currentTimeMillis()} fun showForUser(user: User) { EasyFloat.with(context) .setLayout(R.layout.float_chat_head) { view - val ivAvatar view.findViewByIdCircleImageView(R.id.ivAvatar) val tvUnread view.findViewByIdTextView(R.id.tvUnread) val ivOnline view.findViewByIdImageView(R.id.ivOnline) // 加载用户头像 Glide.with(context).load(user.avatar).into(ivAvatar) // 显示未读消息数 val unreadCount getUnreadCount(user.id) if (unreadCount 0) { tvUnread.visibility View.VISIBLE tvUnread.text if (unreadCount 99) 99 else unreadCount.toString() } else { tvUnread.visibility View.GONE } // 在线状态 ivOnline.visibility if (user.isOnline) View.VISIBLE else View.GONE // 点击打开聊天界面 view.setOnClickListener { openChatActivity(user.id) EasyFloat.dismiss(TAG) } // 长按显示更多选项 view.setOnLongClickListener { showChatHeadMenu(user) true } } .setTag(TAG) .setShowPattern(ShowPattern.ALL_TIME) .setDragEnable(true) .setSidePattern(SidePattern.RESULT_BOTH) .setGravity(Gravity.END or Gravity.TOP, 20, 100) .setAnimator(ChatHeadAnimator()) // 自定义聊天头像动画 .registerCallback { drag { view, motionEvent - // 拖拽时显示删除区域 showDeleteZoneIfNeeded(view, motionEvent) } dragEnd { // 拖拽结束后吸附到最近边缘 snapToNearestEdge(it) } } .show() } }六、性能优化与最佳实践6.1 内存管理优化// 1. 及时释放悬浮窗资源 override fun onDestroy() { super.onDestroy() // 在Activity销毁时关闭相关悬浮窗 EasyFloat.dismiss(activity_float) } // 2. 使用弱引用避免内存泄漏 class FloatManager { private val floatWeakRefs mutableMapOfString, WeakReferenceView() fun registerFloatView(tag: String, view: View) { floatWeakRefs[tag] WeakReference(view) } fun getFloatView(tag: String): View? { return floatWeakRefs[tag]?.get() } } // 3. 合理使用页面过滤减少资源消耗 EasyFloat.with(applicationContext) .setShowPattern(ShowPattern.ALL_TIME) .setFilter( SplashActivity::class.java, LoginActivity::class.java, FullscreenVideoActivity::class.java ) // 在这些页面不显示悬浮窗 .show()6.2 用户体验优化// 1. 添加拖拽反馈 .setDragEnable(true) .registerCallback { drag { view, motionEvent - // 拖拽时添加视觉反馈 view.animate().scaleX(1.1f).scaleY(1.1f).setDuration(100).start() // 震动反馈 if (motionEvent.action MotionEvent.ACTION_DOWN) { val vibrator context.getSystemService(Context.VIBRATOR_SERVICE) as Vibrator vibrator.vibrate(VibrationEffect.createOneShot(50, VibrationEffect.DEFAULT_AMPLITUDE)) } } dragEnd { // 拖拽结束后恢复原状 it.animate().scaleX(1f).scaleY(1f).setDuration(100).start() } } // 2. 智能显示策略 fun showSmartFloat(context: Context, shouldShow: Boolean) { if (shouldShow !EasyFloat.isShow()) { // 根据设备状态决定显示位置 val display DisplayUtils.getDisplayMetrics(context) val yPosition if (display.heightPixels 2000) 300 else 150 EasyFloat.with(context) .setLayout(R.layout.float_smart) .setGravity(Gravity.END or Gravity.TOP, 20, yPosition) .show() } else if (!shouldShow) { EasyFloat.hide() } }七、常见问题与解决方案7.1 权限相关问题// 权限检查与申请的最佳实践 fun checkAndRequestFloatPermission(activity: Activity, onResult: (Boolean) - Unit) { if (PermissionUtils.checkPermission(activity)) { onResult(true) } else { AlertDialog.Builder(activity) .setTitle(悬浮窗权限申请) .setMessage(使用悬浮窗功能需要您授权悬浮窗权限) .setPositiveButton(去开启) { _, _ - // 自动申请权限 EasyFloat.with(activity) .setLayout(R.layout.float_permission_hint) .setShowPattern(ShowPattern.ALL_TIME) .registerCallback { createResult { isCreated, msg, _ - onResult(isCreated) if (!isCreated) { // 权限申请失败提供手动引导 showManualPermissionGuide(activity) } } } .show() } .setNegativeButton(取消) { _, _ - onResult(false) } .show() } }7.2 多悬浮窗冲突处理// 使用标签系统管理多个悬浮窗 object FloatCoordinator { private val activeFloats mutableSetOfString() fun showFloat(tag: String, config: FloatConfig) { // 检查是否已存在相同标签的悬浮窗 if (activeFloats.contains(tag)) { EasyFloat.dismiss(tag) } // 创建新的悬浮窗 EasyFloat.with(config.context) .applyConfig(config) .setTag(tag) .registerCallback { createResult { isCreated, _, _ - if (isCreated) { activeFloats.add(tag) } } dismiss { activeFloats.remove(tag) } } .show() } fun hideAll() { activeFloats.forEach { tag - EasyFloat.hide(tag) } } fun dismissAll() { activeFloats.forEach { tag - EasyFloat.dismiss(tag) } activeFloats.clear() } }八、总结与展望通过本文的实战案例我们可以看到EasyFloat框架的强大功能和灵活性。无论是简单的提示框还是复杂的交互式悬浮窗EasyFloat都能提供优雅的解决方案。关键优势总结开发效率高链式调用配置简单大幅减少样板代码功能全面支持多种显示模式、拖拽吸附、动画效果等稳定性好完善的权限管理和生命周期控制扩展性强支持自定义View、自定义动画、自定义回调图EasyFloat提供丰富的拖拽交互功能支持拖拽关闭、边界限制等特性未来发展方向支持更多动画效果和交互手势增强多显示器适配能力提供更多预设的悬浮窗模板优化性能减少内存占用EasyFloat让Android悬浮窗开发变得前所未有的简单高效。无论是新手开发者还是经验丰富的工程师都能快速上手并构建出功能丰富的悬浮窗应用。现在就开始使用EasyFloat为你的应用添加炫酷的悬浮窗功能吧项目源码结构参考核心类EasyFloat.kt窗口管理FloatingWindowManager.kt配置类FloatConfig.kt权限管理PermissionUtils.kt示例代码MainActivity.kt【免费下载链接】EasyFloat EasyFloat浮窗从未如此简单Android可拖拽悬浮窗口支持页面过滤、自定义动画可设置单页面浮窗、前台浮窗、全局浮窗浮窗权限按需自动申请...项目地址: https://gitcode.com/gh_mirrors/ea/EasyFloat创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考