flutter_overlay_window_fork 是一个用于在 Flutter 应用中创建和管理悬浮窗的插件。它允许你在应用的其他界面之上显示一个独立的悬浮窗口，适用于需要常驻显示一些信息或操作的情况，比如显示当前播放的音乐、悬浮球等。

以下是如何使用 flutter_overlay_window_fork 插件的基本步骤：

1. 添加依赖

首先，在 pubspec.yaml 文件中添加 flutter_overlay_window_fork 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  flutter_overlay_window_fork: ^0.0.1 # 请查看最新版本

然后运行 flutter pub get 来获取依赖。

2. 请求悬浮窗权限

在 Android 上，使用悬浮窗功能需要请求 SYSTEM_ALERT_WINDOW 权限。你需要在 AndroidManifest.xml 文件中添加以下权限声明：

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

然后，你需要在运行时请求这个权限：

import 'package:flutter_overlay_window_fork/flutter_overlay_window_fork.dart';

Future<void> requestOverlayPermission() async {
  if (!await FlutterOverlayWindowFork.isPermissionGranted()) {
    await FlutterOverlayWindowFork.requestPermission();
  }
}

3. 创建悬浮窗

你可以使用 FlutterOverlayWindowFork.showOverlay 方法来创建一个悬浮窗。这个方法需要传递一个 OverlayWindowConfig 对象来配置悬浮窗的行为和外观。

import 'package:flutter/material.dart';
import 'package:flutter_overlay_window_fork/flutter_overlay_window_fork.dart';

void showOverlayWindow() async {
  await FlutterOverlayWindowFork.showOverlay(
    overlayWindowConfig: OverlayWindowConfig(
      width: 200,
      height: 200,
      alignment: OverlayAlignment.center,
      gravity: OverlayGravity.center,
      overlayContent: (BuildContext context) {
        return MaterialApp(
          home: Scaffold(
            backgroundColor: Colors.transparent,
            body: Center(
              child: Container(
                width: 200,
                height: 200,
                color: Colors.blue,
                child: Center(
                  child: Text(
                    '悬浮窗内容',
                    style: TextStyle(color: Colors.white),
                  ),
                ),
              ),
            ),
          ),
        );
      },
    ),
  );
}

4. 关闭悬浮窗

你可以使用 FlutterOverlayWindowFork.closeOverlay 方法来关闭悬浮窗：

void closeOverlayWindow() async {
  await FlutterOverlayWindowFork.closeOverlay();
}

5. 处理悬浮窗的生命周期

你可以通过监听悬浮窗的生命周期事件来处理悬浮窗的显示和隐藏：

FlutterOverlayWindowFork.overlayWindowLifecycleStream.listen((event) {
  if (event == OverlayWindowLifecycleEvent.show) {
    print('悬浮窗显示');
  } else if (event == OverlayWindowLifecycleEvent.hide) {
    print('悬浮窗隐藏');
  }
});

6. 处理悬浮窗的点击事件

你可以在悬浮窗的内容中添加点击事件处理逻辑：

overlayContent: (BuildContext context) {
  return MaterialApp(
    home: Scaffold(
      backgroundColor: Colors.transparent,
      body: Center(
        child: GestureDetector(
          onTap: () {
            print('悬浮窗被点击');
          },
          child: Container(
            width: 200,
            height: 200,
            color: Colors.blue,
            child: Center(
              child: Text(
                '悬浮窗内容',
                style: TextStyle(color: Colors.white),
              ),
            ),
          ),
        ),
      ),
    ),
  );
},

7. 处理悬浮窗的拖拽事件

你可以在悬浮窗的内容中添加拖拽事件处理逻辑：

overlayContent: (BuildContext context) {
  return MaterialApp(
    home: Scaffold(
      backgroundColor: Colors.transparent,
      body: Center(
        child: Draggable(
          child: Container(
            width: 200,
            height: 200,
            color: Colors.blue,
            child: Center(
              child: Text(
                '拖拽我',
                style: TextStyle(color: Colors.white),
              ),
            ),
          ),
          feedback: Container(
            width: 200,
            height: 200,
            color: Colors.blue.withOpacity(0.5),
            child: Center(
              child: Text(
                '拖拽中',
                style: TextStyle(color: Colors.white),
              ),
            ),
          ),
          childWhenDragging: Container(),
          onDragEnd: (details) {
            print('拖拽结束');
          },
        ),
      ),
    ),
  );
},

8. 其他配置

你还可以通过 OverlayWindowConfig 对象配置悬浮窗的其他行为，比如悬浮窗的位置、大小、是否可拖动等。

9. 注意事项

• 在 Android 上，悬浮窗功能需要用户手动授予 SYSTEM_ALERT_WINDOW 权限。
• 悬浮窗的内容是一个独立的 Flutter 应用，因此它有自己的 MaterialApp 和 Scaffold。
• 悬浮窗的生命周期与主应用的生命周期是独立的，因此需要注意资源的管理和释放。

10. 示例代码

以下是一个完整的示例代码，展示了如何创建、显示、关闭悬浮窗，并处理悬浮窗的生命周期和点击事件：

import 'package:flutter/material.dart';
import 'package:flutter_overlay_window_fork/flutter_overlay_window_fork.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: HomeScreen(),
    );
  }
}

class HomeScreen extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('悬浮窗示例'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            ElevatedButton(
              onPressed: () async {
                await requestOverlayPermission();
                showOverlayWindow();
              },
              child: Text('显示悬浮窗'),
            ),
            ElevatedButton(
              onPressed: () {
                closeOverlayWindow();
              },
              child: Text('关闭悬浮窗'),
            ),
          ],
        ),
      ),
    );
  }
}

Future<void> requestOverlayPermission() async {
  if (!await FlutterOverlayWindowFork.isPermissionGranted()) {
    await FlutterOverlayWindowFork.requestPermission();
  }
}

void showOverlayWindow() async {
  await FlutterOverlayWindowFork.showOverlay(
    overlayWindowConfig: OverlayWindowConfig(
      width: 200,
      height: 200,
      alignment: OverlayAlignment.center,
      gravity: OverlayGravity.center,
      overlayContent: (BuildContext context) {
        return MaterialApp(
          home: Scaffold(
            backgroundColor: Colors.transparent,
            body: Center(
              child: GestureDetector(
                onTap: () {
                  print('悬浮窗被点击');
                },
                child: Container(
                  width: 200,
                  height: 200,
                  color: Colors.blue,
                  child: Center(
                    child: Text(
                      '悬浮窗内容',
                      style: TextStyle(color: Colors.white),
                    ),
                  ),
                ),
              ),
            ),
          ),
        );
      },
    ),
  );
}

void closeOverlayWindow() async {
  await FlutterOverlayWindowFork.closeOverlay();
}