Flutter本地通知接口插件flutter_local_notifications_platform_interface的使用

简介

flutter_local_notifications_platform_interface 是 flutter_local_notifications 插件的通用平台接口。它允许开发者为不同的平台（如Android、iOS等）实现特定的通知功能。

使用方法

引入依赖

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

dependencies:
  flutter:
    sdk: flutter
  flutter_local_notifications: ^13.0.0

然后运行 flutter pub get 来安装依赖。

初始化和配置

创建FlutterLocalNotificationsPlugin实例

你需要创建一个 FlutterLocalNotificationsPlugin 实例来管理通知：

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  // 初始化通知插件
  final FlutterLocalNotificationsPlugin flutterLocalNotificationsPlugin = FlutterLocalNotificationsPlugin();

  // 设置初始化设置
  const AndroidInitializationSettings initializationSettingsAndroid =
      AndroidInitializationSettings('@mipmap/ic_launcher');
  final InitializationSettings initializationSettings = InitializationSettings(
    android: initializationSettingsAndroid,
  );

  await flutterLocalNotificationsPlugin.initialize(initializationSettings);

  runApp(MyApp(flutterLocalNotificationsPlugin));
}

定义平台特定实现

如果你需要自定义平台特定的行为，可以通过继承 FlutterLocalNotificationsPlatform 类来实现：

class MyFlutterLocalNotificationsPlatform extends FlutterLocalNotificationsPlatform {
  @override
  Future<void> initialize(InitializationSettings initializationSettings, Function onSelectNotification) async {
    // 自定义初始化逻辑
    return super.initialize(initializationSettings, onSelectNotification);
  }

  // 其他自定义方法...
}

// 注册自定义实现
FlutterLocalNotificationsPlatform.instance = MyFlutterLocalNotificationsPlatform();

发送本地通知

基本通知

你可以通过 show 方法发送一个简单的本地通知：

class MyApp extends StatelessWidget {
  final FlutterLocalNotificationsPlugin flutterLocalNotificationsPlugin;

  MyApp(this.flutterLocalNotificationsPlugin);

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('Flutter Local Notifications')),
        body: Center(
          child: ElevatedButton(
            onPressed: () async {
              await flutterLocalNotificationsPlugin.show(
                0,
                'Plain Title',
                'Plain body',
                NotificationDetails(
                  android: AndroidNotificationDetails(
                    'channel id',
                    'channel name',
                    channelDescription: 'channel description',
                    importance: Importance.max,
                    priority: Priority.high,
                    showWhen: false,
                  ),
                ),
              );
            },
            child: Text('Show notification'),
          ),
        ),
      ),
    );
  }
}

定时通知

你还可以设置定时通知，比如在5秒后触发：

await flutterLocalNotificationsPlugin.zonedSchedule(
  0,
  'scheduled title',
  'scheduled body',
  tz.TZDateTime.now(tz.local).add(const Duration(seconds: 5)),
  NotificationDetails(
    android: AndroidNotificationDetails(
      'your channel id',
      'your channel name',
      channelDescription: 'your channel description',
    ),
  ),
  androidAllowWhileIdle: true,
  uiLocalNotificationDateInterpretation: UILocalNotificationDateInterpretation.absoluteTime,
);

处理通知点击事件

你可以监听通知点击事件，并执行相应的操作：

Future<void> _onSelectNotification(String payload) async {
  if (payload != null) {
    debugPrint('notification payload: $payload');
  }
  // 打开新的页面或执行其他操作
}

final InitializationSettings initializationSettings = InitializationSettings(
  android: initializationSettingsAndroid,
  onSelectNotification: _onSelectNotification,
);

完整示例代码

import 'package:flutter/material.dart';
import 'package:flutter_local_notifications/flutter_local_notifications.dart';
import 'package:timezone/timezone.dart' as tz;
import 'package:timezone/data/latest.dart' as tz;

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  // 初始化时区数据
  tz.initializeTimeZones();

  // 初始化通知插件
  final FlutterLocalNotificationsPlugin flutterLocalNotificationsPlugin = FlutterLocalNotificationsPlugin();

  // 设置初始化设置
  const AndroidInitializationSettings initializationSettingsAndroid =
      AndroidInitializationSettings('@mipmap/ic_launcher');

  final InitializationSettings initializationSettings = InitializationSettings(
    android: initializationSettingsAndroid,
    onSelectNotification: _onSelectNotification,
  );

  await flutterLocalNotificationsPlugin.initialize(initializationSettings);

  runApp(MyApp(flutterLocalNotificationsPlugin));
}

Future<void> _onSelectNotification(String payload) async {
  if (payload != null) {
    debugPrint('notification payload: $payload');
  }
  // 打开新的页面或执行其他操作
}

class MyApp extends StatelessWidget {
  final FlutterLocalNotificationsPlugin flutterLocalNotificationsPlugin;

  MyApp(this.flutterLocalNotificationsPlugin);

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('Flutter Local Notifications')),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: <Widget>[
              ElevatedButton(
                onPressed: () async {
                  await flutterLocalNotificationsPlugin.show(
                    0,
                    'Plain Title',
                    'Plain body',
                    NotificationDetails(
                      android: AndroidNotificationDetails(
                        'channel id',
                        'channel name',
                        channelDescription: 'channel description',
                        importance: Importance.max,
                        priority: Priority.high,
                        showWhen: false,
                      ),
                    ),
                  );
                },
                child: Text('Show notification'),
              ),
              SizedBox(height: 20),
              ElevatedButton(
                onPressed: () async {
                  await flutterLocalNotificationsPlugin.zonedSchedule(
                    0,
                    'scheduled title',
                    'scheduled body',
                    tz.TZDateTime.now(tz.local).add(const Duration(seconds: 5)),
                    NotificationDetails(
                      android: AndroidNotificationDetails(
                        'your channel id',
                        'your channel name',
                        channelDescription: 'your channel description',
                      ),
                    ),
                    androidAllowWhileIdle: true,
                    uiLocalNotificationDateInterpretation: UILocalNotificationDateInterpretation.absoluteTime,
                  );
                },
                child: Text('Show scheduled notification'),
              ),
            ],
          ),
        ),
      ),
    );
  }
}

这个完整的示例展示了如何使用 flutter_local_notifications 插件来发送基本和定时通知，并处理通知点击事件。希望这对你有所帮助！