Android实现悬浮菜单功能（附带源码）
一、项目概述
1.1 项目背景
在很多应用场景中，悬浮菜单作为一种全局、浮在其他界面之上的操作入口，能够让用户在任何页面上都可以快速访问某些常用功能，例如快捷设置、聊天悬浮窗、工具栏、悬浮助手等。实现悬浮菜单功能不仅能优化用户体验，同时能使应用具备更强的互动性和易用性。
Android 平台提供了WindowManager接口，使得开发者可以在应用内乃至系统级别创建悬浮视图（常见于“聊天泡泡”、“悬浮球”等功能）。但由于安全与隐私要求，从Android 6.0开始需要动态申请“系统悬浮窗”权限（SYSTEM_ALERT_WINDOW），而从Android 8.0起则使用TYPE_APPLICATION_OVERLAY来代替。
本项目旨在通过完整的示例代码展示如何在Android中实现悬浮菜单功能。要求将所有Java代码放置在同一个模块中，并在代码内部通过详细备注区分各个类，同时XML文件代码也全部集中写在一起，通过注释进行区分说明。
1.2 项目目标
项目目标包括：
-
在一个单独的模块中实现悬浮菜单功能，所有Java代码（包括MainActivity、悬浮菜单服务FloatingMenuService、自定义悬浮菜单View FloatingMenuView等）全部写在一个文件中，代码中通过备注区分各个类。
-
利用WindowManager在系统窗口上添加悬浮菜单，并支持拖动、点击事件等交互。
-
实现XML布局资源的集中管理，所有相关XML代码写在一个文件中，并通过备注来区分用途（例如悬浮菜单布局、菜单图标布局）。
-
提供详细的代码注释，讲解各方法的原理与实现细节，便于开发者学习与复用。
-
项目支持简单的动画效果与撤销操作，确保用户体验优良。
1.3 应用场景
悬浮菜单功能广泛适用于：
-
系统悬浮窗：例如微信聊天浮窗或悬浮快捷键等。
-
多功能控制中心：在APP中提供全局快捷入口，快速访问设置、帮助等常用功能。
-
工具栏与辅助操作：在某些应用中实现常驻悬浮工具栏，方便用户进行常用操作。
二、相关技术知识
2.1 WindowManager与悬浮窗权限
-
WindowManager
Android提供了WindowManager接口，允许应用在屏幕上添加全局悬浮View。通过LayoutParams设置视图大小、位置、窗口级别、动画等。 -
悬浮窗权限
悬浮窗功能需要动态申请SYSTEM_ALERT_WINDOW权限（或在Android 8.0及以上使用TYPE_APPLICATION_OVERLAY）。开发者需要在Manifest中声明该权限，并在运行时引导用户开启权限。
2.2 Service与全局管理
-
Service
悬浮菜单通常通过Service来实现，使得悬浮菜单在后台独立于Activity运行。Service可通过WindowManager管理悬浮View，保证即使APP切换后悬浮菜单依然存在。 -
生命周期管理
在Service中添加的悬浮View必须在Service销毁时及时移除，以避免内存泄漏和资源浪费。
2.3 自定义View与触摸事件
-
自定义View
通过继承View或其子类（如LinearLayout）实现自定义悬浮菜单UI，利用onDraw()、onTouchEvent()等方法完成图标显示、拖动和点击事件处理。 -
触摸事件与拖动
利用onTouchEvent()捕捉用户拖动悬浮菜单的行为，根据手指移动更新悬浮View的位置，利用WindowManager.updateViewLayout()实时刷新显示位置。
2.4 动画与交互效果
-
属性动画
结合ObjectAnimator、ValueAnimator等属性动画实现悬浮菜单的淡入淡出、放大缩小等过渡效果，增强用户体验。 -
交互动画提示
在悬浮菜单拖动过程中，可结合颜色渐变、透明度变化等动画效果，使得操作更直观。
2.5 XML资源与自定义属性
-
XML布局
可在XML文件中定义悬浮菜单的布局，如菜单按钮、图标、文字等组件，方便统一管理和样式修改。 -
自定义属性
在res/values/attrs.xml中声明自定义属性（例如菜单背景色、图标大小、动画时长等），使得开发者在布局中配置时更加灵活。
三、项目实现思路
本项目基于悬浮窗功能来实现悬浮菜单，其实现思路主要分为以下模块：
3.1 悬浮菜单Service
-
创建一个Service（FloatingMenuService），用于在后台添加和管理悬浮菜单View。
-
在Service中利用WindowManager添加悬浮View，并设置相关LayoutParams（包括窗口类型、标志、位置等）。
-
实现悬浮菜单View的拖动功能：通过自定义View处理触摸事件，在用户拖动时更新LayoutParams，实现菜单View自由移动。
3.2 悬浮菜单自定义View
-
创建自定义悬浮菜单View（FloatingMenuView），可以继承LinearLayout或FrameLayout，将菜单图标和操作按钮放置其中。
-
在自定义View中处理点击事件，例如点击各个按钮触发相应操作（如打开某个Activity、执行某个任务等）。
-
同时处理触摸拖动事件，使得菜单可以在屏幕上自由移动。
3.3 悬浮菜单动画与交互
-
为悬浮菜单的出现与消失添加动画效果，例如淡入淡出或滑动动画。
-
在拖动过程中，可结合动画效果显示背景变化或菜单展开状态。
3.4 权限与生命周期管理
-
在Manifest中声明系统悬浮窗权限（SYSTEM_ALERT_WINDOW）。
-
在Service销毁时及时调用WindowManager.removeView()移除悬浮View，避免内存泄漏。
3.5 代码与XML资源整合
-
按照新要求，所有Java代码写在一个模块中，将所有类整合在一个文件内，并通过备注区分各个类；同样，所有的XML文件代码写在一个文件内，并使用注释区分不同用途。
-
这样可以便于开发者快速理解整体实现结构与细节，不必分散到多个文件。
四、整合代码
下面提供的示例代码全部放在同一个Java文件中，并在代码内部通过详细备注区分各个类；同时，XML文件代码也集中在一起，并通过注释进行区分说明。
注意：此示例中仅作为基本演示，实际项目中可根据需求进一步优化和扩展
4.1 Java代码
// 以下为所有Java类统一放在同一模块中的代码，
// 每个类之间通过详细的注释进行区分
/***************************************
* MainActivity类
* 用于启动悬浮菜单Service，并展示主界面
***************************************/
package com.example.floatingmenu;
import android.content.Intent;
import android.net.Uri;
import android.os.Bundle;
import android.provider.Settings;
import android.view.View;
import android.widget.Button;
import androidx.appcompat.app.AppCompatActivity;
public class MainActivity extends AppCompatActivity {
private static final int REQUEST_CODE_FLOATING_PERMISSION = 1001;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
// 设置布局（以下XML代码在本篇文章后统一给出）
setContentView(R.layout.activity_main);
Button btnStartFloatingMenu = findViewById(R.id.btn_start_floating_menu);
btnStartFloatingMenu.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
// 检查是否有悬浮窗权限
if (!Settings.canDrawOverlays(MainActivity.this)) {
// 没有权限，跳转到系统设置界面让用户开启悬浮窗权限
Intent intent = new Intent(Settings.ACTION_MANAGE_OVERLAY_PERMISSION,
Uri.parse("package:" + getPackageName()));
startActivityForResult(intent, REQUEST_CODE_FLOATING_PERMISSION);
} else {
// 启动悬浮菜单Service
startService(new Intent(MainActivity.this, FloatingMenuService.class));
finish();
}
}
});
}
}
/***************************************
* FloatingMenuService类
* 用于在后台添加并管理悬浮菜单View，
* 实现悬浮窗常驻，并管理该窗口的生命周期
***************************************/
package com.example.floatingmenu;
import android.app.Service;
import android.content.Intent;
import android.graphics.PixelFormat;
import android.os.IBinder;
import android.view.Gravity;
import android.view.LayoutInflater;
import android.view.MotionEvent;
import android.view.View;
import android.view.WindowManager;
public class FloatingMenuService extends Service {
private WindowManager windowManager;
private View floatingMenuView;
@Override
public void onCreate() {
super.onCreate();
windowManager = (WindowManager) getSystemService(WINDOW_SERVICE);
// 加载自定义悬浮菜单布局
floatingMenuView = LayoutInflater.from(this).inflate(R.layout.layout_floating_menu, null);
// 设置WindowManager的LayoutParams
final WindowManager.LayoutParams params = new WindowManager.LayoutParams(
WindowManager.LayoutParams.WRAP_CONTENT,
WindowManager.LayoutParams.WRAP_CONTENT,
// Android 8.0及以上使用TYPE_APPLICATION_OVERLAY，否则使用TYPE_PHONE
android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.O ?
WindowManager.LayoutParams.TYPE_APPLICATION_OVERLAY :
WindowManager.LayoutParams.TYPE_PHONE,
// 设置标志为不影响点击其他区域，例如FLAG_NOT_FOCUSABLE
WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE,
PixelFormat.TRANSLUCENT);
// 悬浮菜单初始位置为屏幕左上角偏右、偏下，可调整
params.gravity = Gravity.TOP | Gravity.START;
params.x = 100;
params.y = 200;
// 添加悬浮菜单View到WindowManager
windowManager.addView(floatingMenuView, params);
// 设置悬浮菜单View拖动功能
floatingMenuView.setOnTouchListener(new FloatingOnTouchListener(params));
}
// 自定义触摸监听，实现悬浮菜单拖动功能
private class FloatingOnTouchListener implements View.OnTouchListener {
private final WindowManager.LayoutParams params;
private int initialX, initialY;
private float initialTouchX, initialTouchY;
public FloatingOnTouchListener(WindowManager.LayoutParams params) {
this.params = params;
}
@Override
public boolean onTouch(View v, MotionEvent event) {
switch (event.getAction()) {
case MotionEvent.ACTION_DOWN:
// 记录初始位置及触摸点
initialX = params.x;
initialY = params.y;
initialTouchX = event.getRawX();
initialTouchY = event.getRawY();
return true;
case MotionEvent.ACTION_MOVE:
// 更新窗口位置
params.x = initialX + (int) (event.getRawX() - initialTouchX);
params.y = initialY + (int) (event.getRawY() - initialTouchY);
windowManager.updateViewLayout(floatingMenuView, params);
return true;
}
return false;
}
}
@Override
public void onDestroy() {
super.onDestroy();
if (floatingMenuView != null) {
windowManager.removeView(floatingMenuView);
}
}
@Override
public IBinder onBind(Intent intent) {
return null;
}
}
/***************************************
* FloatingMenuView类
* 自定义悬浮菜单的UI控件（这里直接在布局XML中定义UI，但如果需要更复杂定制可放入此类）
***************************************/
package com.example.floatingmenu;
import android.content.Context;
import android.util.AttributeSet;
import android.widget.LinearLayout;
public class FloatingMenuView extends LinearLayout {
// 构造函数及初始化代码，可根据需求扩展UI组件，如按钮、图标、文字等
public FloatingMenuView(Context context) {
super(context);
init(context);
}
public FloatingMenuView(Context context, AttributeSet attrs) {
super(context, attrs);
init(context);
}
public FloatingMenuView(Context context, AttributeSet attrs, int defStyleAttr) {
super(context, attrs, defStyleAttr);
init(context);
}
private void init(Context context) {
// 此处可以加载悬浮菜单的布局，或直接构造UI控件
// 本示例中我们通过XML布局来定义外观，此类可扩展额外逻辑
}
}
/***************************************
* End of Java代码模块
* 所有的Java代码均集中在此模块内，通过详细备注进行了类的区分
***************************************/
4.2 XML 文件代码