实现 Android 悬浮 UI 显示的完整指南

一、概述

在 Android 开发中，悬浮 UI（Floating UI）通常是指能够在其他应用程序之上显示的用户界面元素，类似于聊天气泡或播放控制按钮。为了实现这种功能，您需要使用 Service 和 WindowManager。接下来，我将以步骤的形式带你了解实现过程，并详细说明每一步的具体实现方法。

二、实现流程

以下是实现悬浮 UI 的步骤：

步骤描述
1. 创建一个服务使用 Service 处理悬浮窗口的生命周期
2. 请求权限申请 “SYSTEM_ALERT_WINDOW” 权限
3. 创建悬浮窗口通过 WindowManager 创建悬浮窗口
4. 处理用户交互在悬浮窗口上设置点击事件
5. 结束服务清理资源，结束悬浮服务

三、每一步的详细实现

1. 创建一个服务

首先，您需要在项目中创建一个新的 Service，命名为 FloatingViewService。

public class FloatingViewService extends Service {
    // 声明 WindowManager 和 View 变量
    private WindowManager windowManager;
    private View floatingView;

    @Override
    public void onCreate() {
        super.onCreate();
        // 初始化 WindowManager
        windowManager = (WindowManager) getSystemService(WINDOW_SERVICE);

        // 创建悬浮窗口界面
        createFloatingView();
    }
}
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.

注释：

  • onCreate 方法在服务创建时调用，主要用于初始化一些必要的资源。
2. 请求权限

在 AndroidManifest.xml 文件中添加权限请求：

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

注释：

  • 该权限允许您的应用在其他应用之上绘制内容，这是悬浮窗口所必需的。
3. 创建悬浮窗口

接下来，在 createFloatingView 函数中，我们需要初始化悬浮窗口的布局。

private void createFloatingView() {
    // 引入悬浮窗口布局
    floatingView = LayoutInflater.from(this).inflate(R.layout.layout_floating_view, null);

    // 设置布局参数
    final WindowManager.LayoutParams params = new WindowManager.LayoutParams(
            WindowManager.LayoutParams.WRAP_CONTENT,
            WindowManager.LayoutParams.WRAP_CONTENT,
            WindowManager.LayoutParams.TYPE_APPLICATION_OVERLAY, // Android O 及以上版本
            WindowManager.FLAG_NOT_FOCUSABLE,
            PixelFormat.TRANSLUCENT
    );

    // 设置悬浮窗口的初始位置
    params.gravity = Gravity.TOP | Gravity.LEFT;
    params.x = 0;
    params.y = 100;

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

    // 设置点击事件
    floatingView.setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View v) {
            // 启动一个新的activity或处理其他逻辑
            // Intent intent = new Intent(FloatingViewService.this, YourActivity.class);
            // startActivity(intent);
        }
    });
}
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.
  • 24.
  • 25.
  • 26.
  • 27.
  • 28.
  • 29.
  • 30.
  • 31.

注释：

  • 使用 LayoutInflater 加载悬浮窗口的 UI 布局。
  • 设置 WindowManager.LayoutParams 来定义悬浮窗口的大小、类型和位置。
4. 处理用户交互

在上面的 setOnClickListener 方法中，您可以指定当用户点击悬浮窗口时要执行的操作（比如启动一个 Activity 或显示不同的窗口）。

5. 结束服务

为保持良好的资源管理，您需要在服务不再需要时销毁悬浮窗口。

@Override
public void onDestroy() {
    super.onDestroy();
    // 清理资源
    if (floatingView != null) windowManager.removeView(floatingView);
}
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.

注释：

  • onDestroy 方法用于在服务结束时清除悬浮窗口界面。
6. 在 AndroidManifest.xml 中注册服务

最后，不要忘记在 AndroidManifest.xml 中注册您的服务：

<service android:name=".FloatingViewService"
         android:permission="android.permission.SYSTEM_ALERT_WINDOW"/>
  • 1.
  • 2.

四、类图

为了帮助理解，以下是悬浮 UI 实现的类图：

classDiagram
Class FloatingViewService {
    +onCreate()
    +createFloatingView()
    +onDestroy()
}

Class WindowManager {
    +addView(View view, LayoutParams params)
    +removeView(View view)
}

Class LayoutInflater {
    +from(Context context)
    +inflate(int resource, ViewGroup root)
}

五、结论

到此为止，您已经实现了 Android 悬浮 UI 的基本功能。这一过程涉及到编写 Service、请求权限、创建 WindowManager、处理用户交互以及管理服务的生命周期等多个方面。将这些技能结合使用，您可以根据项目的需求，进一步扩展悬浮窗口的功能。希望这篇指南能对您有所帮助，祝您编程愉快！