深入浅出:Android 悬浮窗实现完全指南(基于 WindowManager)

在 Android 应用中,悬浮窗(Floating Window)是一种常见的交互模式,它能够悬浮于其他应用之上,提供快捷操作或信息展示,例如微信的视频通话小窗口、手机管家的清理球、或者一些笔记应用的快捷贴。这种强大的能力主要得益于 Android 系统的 WindowManager 服务。

本文将深入探讨如何使用 WindowManager 实现一个稳定、可靠的悬浮窗。我们将从核心概念讲起,逐步深入到具体实现、权限处理、交互逻辑以及最佳实践,帮助你全面掌握悬浮窗的开发技巧。

目录#

  1. 核心概念理解
  2. 实现步骤详解
  3. 完整示例代码
  4. 常见问题与最佳实践
  5. 总结
  6. 参考资料

核心概念理解#

1.1 什么是 WindowManager?#

WindowManager 是 Android 系统中一个核心的系统服务(通常通过 Context.getSystemService(Context.WINDOW_SERVICE) 获取),它负责管理应用程序的窗口。你可以将其理解为一个“窗口管理员”,它的主要职责包括:

  • 添加窗口:将应用的 View 添加到屏幕上的特定位置。
  • 更新窗口:修改已添加窗口的位置、大小等参数。
  • 移除窗口:将 View 从屏幕上移除。

当我们使用 WindowManager 来添加一个 View 时,这个 View 将不再依赖于传统的 Activity 界面层级,而是直接由系统窗口管理器控制,从而能够显示在其他应用之上,这就是悬浮窗的实现原理。

1.2 悬浮窗的类型与权限#

由于悬浮窗会覆盖在其他应用之上,Android 系统出于安全性和用户体验的考虑,对悬浮窗的使用进行了严格的限制。主要涉及两种窗口类型,对应不同的权限:

  1. TYPE_APPLICATION_PANEL / TYPE_APPLICATION_OVERLAY (API 26+)

    • 描述:这是目前推荐和主流的实现方式。它用于创建与应用本身相关的系统级悬浮窗。
    • 权限:必须在 AndroidManifest.xml 中声明 SYSTEM_ALERT_WINDOW 权限,并且必须在运行时动态向用户申请此权限。
    • 适用版本:TYPE_APPLICATION_OVERLAY 是 Android 8.0(API 26)及更高版本的规范类型。
  2. TYPE_SYSTEM_ALERT (已弃用)

    • 描述:在旧版本 Android(主要是 API 25 及以下)中广泛使用,但现已弃用。它拥有更高的显示层级。
    • 权限:不仅需要 SYSTEM_ALERT_WINDOW 权限,在 Android 6.0 (API 23) 之后,还需要在设置中手动开启“允许在其他应用上层显示”的开关。
    • 注意:强烈不建议再使用此类型,新应用应面向新 API 开发。

关键点:无论选择哪种类型,动态申请 SYSTEM_ALERT_WINDOW 权限是必不可少的步骤,否则悬浮窗将无法显示。

实现步骤详解#

2.1 第一步:申请悬浮窗权限#

这是最关键的一步,如果权限被拒绝,后续所有代码都将无效。

1. 在 AndroidManifest.xml 中声明权限:

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

2. 在代码中动态检查并申请权限:

由于每个厂商的权限管理可能不同,最可靠的方法是使用 Android 官方提供的 Settings.canDrawOverlays(Context) 方法来检查。

public class MainActivity extends AppCompatActivity {
    private static final int REQUEST_CODE_OVERLAY_PERMISSION = 1001;
 
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
 
        Button showFloatingButton = findViewById(R.id.show_floating_button);
        showFloatingButton.setOnClickListener(v -> checkOverlayPermission());
    }
 
    private void checkOverlayPermission() {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
            if (!Settings.canDrawOverlays(this)) {
                // 没有权限,引导用户去设置页面开启
                Intent intent = new Intent(Settings.ACTION_MANAGE_OVERLAY_PERMISSION,
                        Uri.parse("package:" + getPackageName()));
                startActivityForResult(intent, REQUEST_CODE_OVERLAY_PERMISSION);
            } else {
                // 已有权限,开始显示悬浮窗
                showFloatingWindow();
            }
        } else {
            // 在 Android M 以下版本,默认有权限
            showFloatingWindow();
        }
    }
 
    @Override
    protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
        super.onActivityResult(requestCode, resultCode, data);
        if (requestCode == REQUEST_CODE_OVERLAY_PERMISSION) {
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
                if (Settings.canDrawOverlays(this)) {
                    showFloatingWindow();
                } else {
                    // 用户拒绝了权限,给出提示
                    Toast.makeText(this, "悬浮窗权限被拒绝,无法显示悬浮窗", Toast.LENGTH_LONG).show();
                }
            }
        }
    }
 
    private void showFloatingWindow() {
        // 在这里启动悬浮窗服务或直接显示悬浮窗
        startService(new Intent(MainActivity.this, FloatingWindowService.class));
    }
}

2.2 第二步:创建悬浮窗布局#

创建一个简单的 XML 布局文件 layout_floating_window.xml。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/floating_window_layout"
    android:layout_width="150dp"
    android:layout_height="150dp"
    android:background="@drawable/circle_background"
    android:gravity="center"
    android:orientation="vertical"
    android:padding="10dp">
 
    <ImageView
        android:id="@+id/iv_close"
        android:layout_width="30dp"
        android:layout_height="30dp"
        android:layout_gravity="end"
        android:src="@android:drawable/ic_menu_close_clear_cancel" />
 
    <TextView
        android:id="@+id/tv_content"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="悬浮窗"
        android:textColor="@android:color/white"
        android:textSize="16sp" />
 
</LinearLayout>

2.3 第三步:配置 WindowManager.LayoutParams#

WindowManager.LayoutParams(简称 LayoutParams)是悬浮窗的“身份证”和“行为准则”,它定义了窗口的几乎所有属性。

// 获取 WindowManager
WindowManager windowManager = (WindowManager) getSystemService(WINDOW_SERVICE);
 
// 创建 LayoutParams
WindowManager.LayoutParams layoutParams = new WindowManager.LayoutParams();
 
// 1. 设置窗口类型
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
    // Android 8.0 及以上使用 TYPE_APPLICATION_OVERLAY
    layoutParams.type = WindowManager.LayoutParams.TYPE_APPLICATION_OVERLAY;
} else {
    // Android 8.0 以下使用已弃用但有效的 TYPE_SYSTEM_ALERT
    layoutParams.type = WindowManager.LayoutParams.TYPE_SYSTEM_ALERT;
}
 
// 2. 设置行为标志
layoutParams.flags = WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE;
// 解释一些常用 flags:
// FLAG_NOT_FOCUSABLE: 窗口不会获得输入焦点,点击事件会直接透传到下方的窗口。这对于不需要输入文本的悬浮窗非常有用,避免影响下层应用。
// FLAG_NOT_TOUCH_MODAL: 窗口区域内的触摸事件由自己处理,区域外的事件传递给其他窗口。通常与 FLAG_NOT_FOCUSABLE 结合使用。
// FLAG_WATCH_OUTSIDE_TOUCH: 允许接收窗口区域外的触摸事件(MotionEvent.ACTION_OUTSIDE)。
 
// 3. 设置格式
layoutParams.format = PixelFormat.TRANSLUCENT; // 支持透明背景
 
// 4. 设置初始位置和大小
layoutParams.width = WindowManager.LayoutParams.WRAP_CONTENT;
layoutParams.height = WindowManager.LayoutParams.WRAP_CONTENT;
layoutParams.x = 0; // X 坐标
layoutParams.y = 0; // Y 坐标
 
// 5. 设置重力(参考点)
layoutParams.gravity = Gravity.START | Gravity.TOP; // 坐标 (x, y) 的参考点是屏幕左上角

2.4 第四步:添加悬浮窗到屏幕#

通常,我们将悬浮窗的逻辑放在一个 Service 中,这样即使应用退到后台,悬浮窗也能保持显示。

public class FloatingWindowService extends Service {
 
    private WindowManager windowManager;
    private View floatingView;
    private WindowManager.LayoutParams layoutParams;
 
    @Override
    public void onCreate() {
        super.onCreate();
        windowManager = (WindowManager) getSystemService(WINDOW_SERVICE);
        floatingView = LayoutInflater.from(this).inflate(R.layout.layout_floating_window, null);
        layoutParams = createLayoutParams();
 
        setupClickListeners();
        
        // 将 View 添加到窗口
        windowManager.addView(floatingView, layoutParams);
    }
 
    private WindowManager.LayoutParams createLayoutParams() {
        // ... 参数配置代码如上一步所示 ...
        return layoutParams;
    }
 
    private void setupClickListeners() {
        // 关闭按钮
        floatingView.findViewById(R.id.iv_close).setOnClickListener(v -> {
            stopSelf(); // 停止服务,从而移除悬浮窗
        });
 
        // 悬浮窗主体点击事件
        floatingView.findViewById(R.id.floating_window_layout).setOnClickListener(v -> {
            Toast.makeText(this, "悬浮窗被点击了!", Toast.LENGTH_SHORT).show();
            // 这里可以打开一个 Activity 或者执行其他操作
        });
    }
 
    @Override
    public void onDestroy() {
        super.onDestroy();
        if (floatingView != null) {
            windowManager.removeView(floatingView); // 务必在服务销毁时移除 View
        }
    }
 
    @Nullable
    @Override
    public IBinder onBind(Intent intent) {
        return null;
    }
}

2.5 第五步:实现悬浮窗的拖拽移动#

拖拽功能是通过监听悬浮窗的触摸事件来实现的。

private void setupClickListeners() {
    // ... 其他点击监听 ...
 
    // 实现拖拽逻辑
    View dragArea = floatingView.findViewById(R.id.floating_window_layout); // 整个布局作为拖拽区域
 
    dragArea.setOnTouchListener(new View.OnTouchListener() {
        private int initialX, initialY;
        private float initialTouchX, initialTouchY;
 
        @Override
        public boolean onTouch(View v, MotionEvent event) {
            switch (event.getAction()) {
                case MotionEvent.ACTION_DOWN:
                    // 按下时记录初始位置
                    initialX = layoutParams.x;
                    initialY = layoutParams.y;
                    initialTouchX = event.getRawX();
                    initialTouchY = event.getRawY();
                    return true; // 消费事件
 
                case MotionEvent.ACTION_MOVE:
                    // 计算移动的偏移量
                    int deltaX = (int) (event.getRawX() - initialTouchX);
                    int deltaY = (int) (event.getRawY() - initialTouchY);
 
                    // 更新窗口位置
                    layoutParams.x = initialX + deltaX;
                    layoutParams.y = initialY + deltaY;
 
                    // 刷新窗口
                    windowManager.updateViewLayout(floatingView, layoutParams);
                    return true;
 
                case MotionEvent.ACTION_UP:
                    // 抬起时,可以添加一些边界吸附效果(可选)
                    // 例如,如果靠近屏幕边缘,自动吸附到边缘
                    snapToEdge();
                    return true;
            }
            return false;
        }
    });
}
 
// 边界吸附效果示例
private void snapToEdge() {
    int screenWidth = getResources().getDisplayMetrics().widthPixels;
    int middleX = screenWidth / 2;
 
    // 如果当前位置在屏幕右半部分,吸附到右边;否则吸附到左边。
    if (layoutParams.x > middleX) {
        layoutParams.x = screenWidth - floatingView.getWidth(); // 吸附到右边缘
    } else {
        layoutParams.x = 0; // 吸附到左边缘
    }
    windowManager.updateViewLayout(floatingView, layoutParams);
}

2.6 第六步:移除悬浮窗#

移除悬浮窗非常简单,但至关重要,避免资源泄露。

// 在 Service 的 onDestroy() 中移除
@Override
public void onDestroy() {
    super.onDestroy();
    if (floatingView != null && windowManager != null) {
        windowManager.removeView(floatingView);
    }
}
 
// 或者在 Activity/Fragment 中主动关闭
// windowManager.removeView(floatingView);

完整示例代码#

由于篇幅限制,完整的项目代码可以整合如下:

  1. AndroidManifest.xml: 注册权限和服务。
  2. MainActivity.java: 处理权限申请。
  3. FloatingWindowService.java: 承载悬浮窗的核心逻辑,包括创建、拖拽、移除。
  4. layout_floating_window.xml: 悬浮窗的界面布局。

将上述各部分代码组合起来,即可形成一个完整的、可运行的悬浮窗示例。

常见问题与最佳实践#

4.1 常见问题#

  • Q:悬浮窗不显示?
    • A:99% 的原因是权限问题。请确保:
      1. 已在 Manifest 中声明 SYSTEM_ALERT_WINDOW。
      2. 已使用 Settings.canDrawOverlays(context) 检查并已引导用户开启权限。
      3. 用户确实在设置中开启了权限。
  • Q:点击悬浮窗无响应,或者点击事件透传到下层应用?
    • A:检查 LayoutParams.flags。如果设置了 FLAG_NOT_FOCUSABLE,你需要确保你的 View 正确消费了触摸事件。如果不需要透传,可以移除该 flag,但这可能会影响下层应用。
  • Q:悬浮窗在应用切到后台或被杀死后消失了?
    • A:确保悬浮窗是在一个前台服务(Foreground Service) 中创建和管理的。普通 Service 在应用进程被系统回收时可能会被终止。使用 startForegroundService() 并创建一个持续的通知来提升服务优先级。

4.2 最佳实践#

  1. 使用前台服务(Foreground Service):为了确保悬浮窗的稳定性,尤其是在 Android 8.0 之后严格的后台限制下,务必使用前台服务来管理悬浮窗的生命周期。

    // 在 Service 的 onCreate 或 onStartCommand 中
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
        NotificationChannel channel = new NotificationChannel(...);
        ((NotificationManager) getSystemService(NOTIFICATION_SERVICE)).createNotificationChannel(channel);
        Notification notification = new Notification.Builder(this, CHANNEL_ID).build();
        startForeground(ONGOING_NOTIFICATION_ID, notification);
    }
  2. 谨慎申请权限:悬浮窗权限非常敏感。在申请前,应向用户清晰说明为什么需要此权限(例如:“用于显示迷你音乐播放器控件”),并在用户拒绝后优雅降级。

  3. 良好的用户体验(UX):

    • 提供明显的关闭入口。
    • 实现边界吸附,避免悬浮窗遮挡关键 UI。
    • 拖拽时提供视觉反馈,如改变透明度或尺寸。
    • 考虑在游戏、视频播放等全屏场景下自动隐藏悬浮窗。
  4. 内存管理:在 Service 的 onDestroy() 中务必调用 windowManager.removeView(),防止 View 泄露。

  5. 兼容性测试:在不同厂商(华为、小米、OPPO、vivo 等)的 ROM 上充分测试,因为各厂商对悬浮窗权限的管理策略可能有所不同。

总结#

实现 Android 悬浮窗的核心在于理解 WindowManager 的机制和正确处理 SYSTEM_ALERT_WINDOW 权限。通过本文的步骤——从权限申请、参数配置、服务管理到交互实现——你应该能够构建出一个功能完善的悬浮窗。

记住,能力越大,责任越大。悬浮窗是一把双刃剑,滥用会严重影响用户体验。请务必遵循最佳实践,在提供便利的同时,尊重用户的设备和隐私。

参考资料#

  1. Android 官方文档 - WindowManager
  2. Android 官方文档 - WindowManager.LayoutParams
  3. Android 官方文档 - SYSTEM_ALERT_WINDOW 权限
  4. Android 官方文档 - 管理悬浮窗权限