SystemAlertWindow 使用指南

最新推荐文章于 2025-03-10 09:52:31 发布

蓬虎泓Anthea

最新推荐文章于 2025-03-10 09:52:31 发布

阅读量1.2k

点赞数 9

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00828/article/details/141801758

SystemAlertWindow 使用指南

SystemAlertWindowA flutter plugin to show Truecaller like overlay window, over all other apps along with callback events. In Android Go or Android 11 & above, this plugin shows notification bubble, in other android versions, it shows an overlay window.项目地址:https://gitcode.com/gh_mirrors/sy/SystemAlertWindow

项目介绍

SystemAlertWindow 是一个专为 Flutter 应用设计的插件，它允许开发者在其他所有应用程序之上显示一个类似Truecaller的悬浮窗口，并提供了回调事件处理机制。此功能特别适用于需要在任何界面层级上显示重要通知或交互元素的应用场景。自适应Android与iOS平台，确保了跨平台的一致性体验。版本兼容Dart 3及更高，且要求目标SDK版本至少为23（特别是在Android 6.0及以上系统中，遵循权限管理的新规则）。

项目快速启动

要快速集成SystemAlertWindow到你的Flutter项目中，首先你需要在你的pubspec.yaml文件中添加依赖：

dependencies:
  flutter:
    sdk: flutter
  system_alert_window: ^2.0.0

执行flutter pub get来获取依赖项。

接下来，在你的Flutter组件中导入库并展示悬浮窗：

import 'package:flutter/material.dart';
import 'package\system_alert_window\system_alert_window.dart';

void main() => runApp(MyApp());

class MyApp extends StatefulWidget {
  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        body: Center(
          child: ElevatedButton(
            onPressed: () async {
              await SystemAlertWindow.showSystemWindow(
                gravity: SystemWindowGravity.CENTER,
                width: Constants.MATCH_PARENT,
                height: Constants.WRAP_CONTENT,
                notificationTitle: '提示',
                notificationBody: '这是一个悬浮窗示例',
              );
            },
            child: Text('显示悬浮窗'),
          ),
        ),
      ),
    );
  }
}

请注意，如果你的应用目标是Android 6.0（API级别23）及以上，首次请求SYSTEM_ALERT_WINDOW权限时，需要引导用户手动授予该“画中画”权限，除非你的应用是通过Play Store安装，因为从某个版本开始，特定条件下Google Play会自动授予这个权限。