Android悬浮窗实例教程：创建与管理

最新推荐文章于 2025-05-02 00:15:00 发布

Compass宁

最新推荐文章于 2025-05-02 00:15:00 发布

阅读量1.2k

点赞数 20

本文链接：https://blog.csdn.net/weixin_42181686/article/details/146289457

版权

本文还有配套的精品资源，点击获取

简介：本文详细介绍了在Android中实现悬浮窗的技术要点，包括权限申请、API使用和创建简单的悬浮窗Demo。文章强调了 SYSTEM_ALERT_WINDOW 权限的重要性，描述了悬浮窗的实现原理以及如何通过 WindowManager 服务添加自定义布局到系统窗口。还介绍了悬浮窗的移动和拖拽功能实现方法，并提示开发者注意API级别26之后对悬浮窗权限的限制。

1. SYSTEM_ALERT_WINDOW权限的申请与使用

在现代Android应用开发中， SYSTEM_ALERT_WINDOW 权限允许开发者在其他应用之上显示内容，例如悬浮窗。为了合法地使用这项功能，开发者需要了解如何申请和正确使用这一权限。

1.1 权限申请的基础知识

SYSTEM_ALERT_WINDOW 是一种特殊权限，也被称为“draw over other apps”权限。从Android 6.0（API级别23）开始，必须在运行时请求用户授权。开发者必须确保其应用在用户授予此权限之前不能执行任何依赖于悬浮窗的操作。

1.2 申请权限的步骤

首先，我们需要通过 Settings.canDrawOverlays(context) 方法检查是否已经获得了悬浮窗权限。如果没有，则需要引导用户到设置页面进行手动开启。

以下是一个示例代码片段，展示如何检查和申请权限：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M && !Settings.canDrawOverlays(context)) {
    Intent intent = new Intent(Settings.ACTION_MANAGE_OVERLAY_PERMISSION,
        Uri.parse("package:" + context.getPackageName()));
    startActivityForResult(intent, REQUEST_CODE);
}

1.3 权限使用注意事项

获得 SYSTEM_ALERT_WINDOW 权限后，开发者应谨慎使用，保证悬浮窗内容不会遮挡关键信息，不应滥用该权限影响用户体验。同时，还需要注意对不同Android版本的兼容性问题，确保悬浮窗在不同设备上的正常工作。

通过本章的学习，开发者应该已经掌握了 SYSTEM_ALERT_WINDOW 权限的基本知识、申请和使用方法，并在应用中为其悬浮窗功能提供了用户授权的基础。接下来的章节将深入探讨Android悬浮窗实现原理，帮助开发者构建更加稳定和高效的应用。

2. Android悬浮窗实现原理

2.1 Android系统窗口管理机制

2.1.1 窗口类型与层次

在Android系统中，所有的用户界面都是以窗口（Window）的形式存在的。每个窗口都有一个类型（Type），这决定了窗口在Z轴上的层次，也就是窗口的前后覆盖关系。窗口类型包括：

应用窗口（Application）：属于当前正在运行的应用，例如Activity窗口。
系统窗口（System）：不属于任何应用，系统用来显示状态栏、导航栏等。
输入法窗口（InputMethod）：显示软键盘。
悬浮窗口（Toast）：显示短暂的提示信息。
悬浮窗（System Alert Window）：一种特殊类型的系统窗口，允许应用显示在所有应用之上的悬浮层。

窗口的层次关系如下：

低层级（Lowest level）：例如锁屏窗口。
应用层级（Application level）：普通应用界面。
悬浮层级（Top-level）：例如通知栏、悬浮窗。
最高层级（Highest level）：例如输入法窗口。

2.1.2 窗口的创建和销毁流程

窗口的创建流程是这样的：

应用程序通过Activity Manager启动Activity。
Activity通过WindowManager的接口创建窗口。
系统为每个窗口分配一个WindowToken，用于标识和管理窗口。
窗口通过Surface持有显示内容，并将其传递给WindowManagerService（WMS）。
WMS根据窗口类型和属性决定其在Z轴的位置和显示层次。

窗口的销毁流程通常伴随着Activity的销毁：

Activity调用finish()方法结束自身。
系统通过WMS通知窗口需要销毁。
应用释放与窗口相关的所有资源。
窗口从WMS中移除，窗口的Surface也会被销毁。

2.2 悬浮窗与系统权限的关系

2.2.1 权限的分类与重要性

在Android系统中，权限是用来控制应用对系统资源和用户数据访问的一种机制。权限分为以下几类：

普通权限：对用户体验影响较小，申请时系统自动授权。
危险权限：可能会影响用户隐私或设备操作，需要用户明确授权。
特殊权限：如安装应用、修改系统设置等，具有高度风险，需要额外的用户操作。

权限对悬浮窗的重要性体现在，若要显示在其他应用之上，必须获得SYSTEM_ALERT_WINDOW权限。这个权限是特殊权限的一种，用户必须在系统设置中明确授权。

2.2.2 SYSTEM_ALERT_WINDOW权限的特性

SYSTEM_ALERT_WINDOW权限允许应用在所有应用之上显示一个悬浮窗口。这个窗口可以接收用户输入，但不会触发其他窗口的事件，例如点击下面的Activity时，悬浮窗仍然可以接收触摸事件。

拥有此权限后，应用能够：

在其他应用的窗口上显示内容。
接收触摸事件，而不会被其他应用的窗口“抢夺”。
使用系统的输入事件（如按键）。

但同时，滥用该权限可能会对用户体验造成负面影响，比如遮挡重要信息、影响操作等。因此，在实现悬浮窗功能时，开发者需要确保悬浮窗的设计合理、用户友好，并且遵守系统安全策略。

2.2.3 SYSTEM_ALERT_WINDOW权限的实现方式

实现SYSTEM_ALERT_WINDOW权限功能需要以下几个步骤：

在应用的AndroidManifest.xml文件中声明权限。 xml <uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW"/>
在应用中请求权限。对于Android 6.0（API级别23）及以上版本，需要动态请求权限。 java if (!Settings.canDrawOverlays(context)) { Intent intent = new Intent(Settings.ACTION_MANAGE_OVERLAY_PERMISSION, Uri.parse("package:" + context.getPackageName())); startActivityForResult(intent, REQUEST_CODE); }
实现悬浮窗的显示逻辑，通常需要使用WindowManager服务。 java WindowManager windowManager = (WindowManager) getSystemService(WINDOW_SERVICE); WindowManager.LayoutParams params = new WindowManager.LayoutParams( WindowManager.LayoutParams.WRAP_CONTENT, WindowManager.LayoutParams.WRAP_CONTENT, WindowManager.LayoutParams.TYPE_APPLICATION_OVERLAY, WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE, PixelFormat.TRANSLUCENT); // 设置悬浮窗的参数，如位置、尺寸等 windowManager.addView(mView, params);
遵守用户的选择，如果用户拒绝授权，则应用不能实现悬浮窗功能，需要提示用户并引导到设置页面。

通过这样的步骤，应用可以利用SYSTEM_ALERT_WINDOW权限合法地创建悬浮窗，提升用户体验，同时保持对系统安全的尊重和遵守。

至此，我们已经探讨了Android系统窗口管理机制的基础知识和SYSTEM_ALERT_WINDOW权限的重要性及实现方式。在下一章中，我们将深入学习WindowManager服务的具体使用方法，以及如何通过addView()方法来添加悬浮窗。

3. WindowManager服务与addView()方法

3.1 WindowManager服务详解

3.1.1 WindowManager的基本概念

在Android应用开发中，WindowManager是一个非常关键的服务，负责管理窗口（Window）的添加、删除和位置调整等操作。WindowManager继承自接口ViewManager，因此它可以被视为一种特殊的ViewGroup，它位于整个视图层次结构的顶端，能够创建和管理系统级的窗口。

WindowManager服务运行在系统进程中，通过一个名为WindowManagerService的系统服务进行通信。当应用需要在屏幕上显示一个窗口时，它会向WindowManagerService请求创建窗口，并传递一个窗口参数对象（WindowManager.LayoutParams）来描述窗口的类型、布局参数和行为特征。

3.1.2 WindowManager的使用方法和注意事项

使用WindowManager时，开发者通常通过调用Context的getSystemService方法并传入Context.WINDOW_SERVICE常量来获取WindowManager实例。

WindowManager windowManager = (WindowManager) getSystemService(WINDOW_SERVICE);

在使用WindowManager添加窗口之前，需要注意以下几点：

确保应用具备了创建悬浮窗所需的权限（如SYSTEM_ALERT_WINDOW）。在Android 6.0以上版本，还需要在运行时请求用户授权。
对于特定类型的窗口（如TYPE_SYSTEM_ALERT），只能在具有特定权限的应用程序中使用。
不同类型的窗口可以拥有不同的层级（z-order），需要根据应用的需求选择合适的窗口类型。
使用WindowManager添加的窗口会脱离常规的Activity生命周期，需要手动管理窗口的显示和隐藏。
在进行布局时，要考虑到不同的屏幕尺寸和分辨率，确保悬浮窗在不同设备上的表现一致。

3.2 使用addView()方法添加悬浮窗

3.2.1 addView()方法的参数解析

addView()方法是WindowManager接口中用于添加视图（View）到窗口中的一种方法。该方法的定义如下：

void addView(View view, WindowManager.LayoutParams params)

其中，view参数是指定要添加到窗口中的视图对象，params是一个WindowManager.LayoutParams对象，用于详细描述视图的布局参数和行为属性。

3.2.2 addView()在悬浮窗中的应用实例

下面是使用addView()方法添加悬浮窗的一个实际例子。代码展示了如何创建一个简单的自定义悬浮窗，并使用addView()方法将其添加到WindowManager中。

// 创建一个线性布局作为悬浮窗的根视图
LinearLayout floatingView = new LinearLayout(this);
floatingView.setBackgroundColor(Color.BLACK);
floatingView.setPadding(10, 10, 10, 10);
floatingView.setOrientation(LinearLayout.VERTICAL);

// 初始化TextView
TextView textView = new TextView(this);
textView.setText("这是一个悬浮窗");
textView.setTextColor(Color.WHITE);
textView.setTextSize(16);
textView.setGravity(Gravity.CENTER);

// 将TextView添加到布局中
floatingView.addView(textView);

// 设置悬浮窗的布局参数
WindowManager.LayoutParams params = new WindowManager.LayoutParams(
    WindowManager.LayoutParams.WRAP_CONTENT,
    WindowManager.LayoutParams.WRAP_CONTENT,
    WindowManager.LayoutParams.TYPE_APPLICATION_OVERLAY,
    WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE,
    PixelFormat.TRANSLUCENT);

// 获取WindowManager服务并添加悬浮窗视图
WindowManager windowManager = (WindowManager) getSystemService(WINDOW_SERVICE);
windowManager.addView(floatingView, params);

在此代码中，首先创建了一个LinearLayout作为悬浮窗的容器，并为其添加了一个TextView。然后创建了一个WindowManager.LayoutParams对象，其中指定了悬浮窗的位置为屏幕上的任意位置（WRAP_CONTENT），类型为TYPE_APPLICATION_OVERLAY（Android 6.0及以上版本推荐使用的悬浮窗类型），标志位设置为FLAG_NOT_FOCUSABLE以避免悬浮窗获取焦点。最后，通过WindowManager将布局添加到屏幕上。

以上实例仅展示了悬浮窗的基本创建过程，实际应用中可能需要更多的配置和优化，例如悬浮窗的移动、拖拽、触摸事件处理等。

4. 创建自定义悬浮窗布局

4.1 悬浮窗布局设计原则

4.1.1 用户交互与视觉体验

在设计悬浮窗布局时，开发者必须兼顾到用户交互和视觉体验两个方面。悬浮窗作为一种特殊的应用界面形式，应简洁明了，提供直观的操作方式，让用户易于理解与使用。在视觉上，悬浮窗的颜色、大小、形状、动画等都应遵循一致的设计风格，确保用户在不同的应用场景下有良好的视觉体验。

4.1.2 布局文件的编写与优化

悬浮窗的布局文件通常定义在res/layout目录下。布局设计时应充分考虑内容的层次性、布局的灵活性以及未来的可扩展性。XML布局文件可以通过定义不同的ViewGroup实现复杂的布局结构。布局编写完成后，进行适当的优化工作，比如减少不必要的嵌套、使用合适的布局权重等，这些都是提高布局渲染效率的关键。

4.2 悬浮窗布局实现代码分析

4.2.1 XML布局文件与代码结构

<!-- res/layout/custom_float_view.xml -->
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:orientation="vertical"
    android:padding="10dp">
    <TextView
        android:id="@+id/textViewTitle"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="悬浮窗标题"
        android:textSize="16sp" />
    <!-- 添加其他需要的控件 -->
</LinearLayout>

上述XML布局文件定义了一个基本的悬浮窗，包含一个标题文本视图。实际开发中，悬浮窗的复杂性可能更高，包含更多控件和交互逻辑。布局文件与Activity或Fragment的代码结构密切相关，开发者需要根据实际需要，将布局文件与Java/Kotlin代码进行合理组织。

4.2.2 布局参数的配置与调整

在自定义悬浮窗的实现中，布局参数的配置是关键。布局参数允许开发者指定视图的大小、位置以及如何填充其父布局。例如，使用WindowManager.LayoutParams来设置悬浮窗的宽度、高度、位置和行为等属性：

val params = WindowManager.LayoutParams(
    WindowManager.LayoutParams.WRAP_CONTENT,
    WindowManager.LayoutParams.WRAP_CONTENT,
    WindowManager.LayoutParams.TYPE_APPLICATION_OVERLAY,
    WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE,
    PixelFormat.TRANSLUCENT
)

params.gravity = Gravity.TOP or Gravity.LEFT
params.x = 0
params.y = 100

// 将悬浮窗视图添加到WindowManager
windowManager.addView(floatingView, params)

上述代码片段展示了如何使用WindowManager.LayoutParams来调整悬浮窗视图的布局参数。其中， WindowManager.LayoutParams.TYPE_APPLICATION_OVERLAY 表明了悬浮窗的类型是应用层的叠加层。此外， FLAG_NOT_FOCUSABLE 标志确保悬浮窗不会获取焦点。 params.gravity 设定悬浮窗相对于父布局的位置， params.x 和 params.y 则分别设定悬浮窗的水平和垂直位置。通过这些参数的配置，可以实现悬浮窗的精确定位和自定义布局。

以上代码块的执行逻辑说明了在将悬浮窗视图添加到WindowManager之前，需要先配置适当的布局参数，这样才能确保悬浮窗在应用中按预期显示。

通过本章节的介绍，我们了解了悬浮窗布局设计的原则，分析了XML布局文件与代码结构的结合方式，并详细探讨了布局参数的配置与调整方法，为实现自定义悬浮窗奠定了基础。接下来的章节，我们将进一步探讨悬浮窗的移动和拖拽功能实现。

5. 悬浮窗移动和拖拽功能实现

实现悬浮窗的移动和拖拽功能是提升用户交互体验的重要部分。对于用户而言，能够自由地在屏幕上移动悬浮窗，能够根据个人喜好和使用习惯放置悬浮窗的位置，这样的设计可以极大地增加应用的吸引力。

5.1 悬浮窗移动功能的实现原理

5.1.1 触摸事件的拦截与处理

在Android系统中，触摸事件的处理对于实现悬浮窗的移动功能至关重要。首先，需要通过 View.OnTouchListener 接口来获取触摸事件。当用户触摸悬浮窗时，系统会发送一系列触摸事件，例如 ACTION_DOWN 、 ACTION_MOVE 和 ACTION_UP 。其中， ACTION_DOWN 事件标记触摸开始， ACTION_MOVE 事件处理移动逻辑，而 ACTION_UP 事件则表示触摸结束。在 ACTION_MOVE 阶段，通过计算触摸点的偏移量，更新悬浮窗的位置参数，实现移动效果。

5.1.2 移动功能的核心代码解析

view.setOnTouchListener(new View.OnTouchListener() {
    private int initialX;
    private int initialY;
    private float initialTouchX;
    private float initialTouchY;

    @Override
    public boolean onTouch(View v, MotionEvent event) {
        switch (event.getAction()) {
            case MotionEvent.ACTION_DOWN:
                initialX = mWindowManager.LayoutParams.x;
                initialY = mWindowManager.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);
               悬浮窗布局参数更新代码;
                mWindowManager.LayoutParams.x = initialX + deltaX;
                mWindowManager.LayoutParams.y = initialY + deltaY;
                mWindowManager.updateViewLayout(view, mWindowManager.LayoutParams);
                return true;
        }
        return false;
    }
});

在上述代码片段中，首先记录了触摸开始时悬浮窗的位置（ initialX 和 initialY ）以及触摸点的位置（ initialTouchX 和 initialTouchY ）。当接收到 ACTION_MOVE 事件时，计算触摸点与初始触摸点的偏移量（ deltaX 和 deltaY ），然后更新悬浮窗的布局参数，并通过 WindowManager 更新悬浮窗的位置。

5.2 悬浮窗拖拽功能的详细实现

5.2.1 拖拽功能的需求分析

除了简单的触摸移动外，悬浮窗的拖拽功能应支持用户通过长按某个区域来激活拖拽模式，并允许用户在拖拽过程中预览新位置的效果。用户释放后，悬浮窗应固定在新位置。这样的需求分析能够帮助开发者明确功能的具体实现方向。

5.2.2 拖拽功能的编码实现与测试

拖拽功能的实现相对复杂，不仅需要监听触摸事件，还需要在拖拽过程中动态地改变悬浮窗的透明度或背景，以此来给用户一个视觉上的反馈。以下是拖拽功能编码实现的简化示例：

view.setOnLongClickListener(new View.OnLongClickListener() {
    @Override
    public boolean onLongClick(View v) {
        // 激活拖拽模式，并显示拖拽辅助视图
        开始拖拽模式;
        return true;
    }
});

view.setOnTouchListener(new View.OnTouchListener() {
    @Override
    public boolean onTouch(View v, MotionEvent event) {
        if (拖拽模式) {
            switch (event.getAction()) {
                case MotionEvent.ACTION_MOVE:
                    // 更新悬浮窗位置逻辑
                    更新悬浮窗位置;
                    break;
                case MotionEvent.ACTION_UP:
                    // 用户释放，隐藏拖拽辅助视图，应用悬浮窗新位置
                    结束拖拽模式;
                    return true;
            }
        }
        return false;
    }
});

在上述代码中， onLongClick 方法用于激活拖拽模式，并显示拖拽辅助视图以提供用户反馈； onTouch 方法用于处理触摸事件，从而更新悬浮窗的位置，并在用户释放时结束拖拽模式。

通过上述实现逻辑，悬浮窗的移动和拖拽功能能够为用户提供更加灵活和直观的操作体验。需要注意的是，这只是一个基础的实现框架，在实际应用中还需要考虑更多边界条件和异常处理，以保证功能的稳定性和可靠性。

本文还有配套的精品资源，点击获取