Flutter闹钟管理插件codenic_alarm的使用

codenic_alarm 是一个用于在 Flutter 应用程序中管理和调度闹钟的插件。通过本指南，我们将了解如何安装和使用 codenic_alarm 插件，并提供一个完整的示例来演示其基本功能。

获取开始

首先，确保你的 Flutter 环境已经正确配置。你可以通过以下命令来创建一个新的 Flutter 项目：

flutter create codenic_alarm_example
cd codenic_alarm_example

接下来，在 pubspec.yaml 文件中添加 codenic_alarm 和 flutter_local_notifications 依赖项：

dependencies:
  flutter:
    sdk: flutter
  codenic_alarm: ^版本号
  flutter_local_notifications: ^版本号

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

初始化插件

在你的应用程序中初始化 codenic_alarm 插件。打开 main.dart 文件并添加以下代码：

import 'dart:io';

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

FlutterLocalNotificationsPlugin flutterLocalNotificationsPlugin = FlutterLocalNotificationsPlugin();

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();

  await CodenicAlarm.instance.initialize();

  final initializationSettingsAndroid = AndroidInitializationSettings('ic_launcher');

  final initializationSettingsIOS = DarwinInitializationSettings(
    notificationCategories: [
      DarwinNotificationCategory(
        'demoCategory',
        options: {
          DarwinNotificationCategoryOption.customDismissAction,
        },
        actions: [
          DarwinNotificationAction.plain(
            'id_1',
            'Action 1',
            options: {
              DarwinNotificationActionOption.foreground,
            },
          ),
          DarwinNotificationAction.plain(
            'id_2',
            'Action 2',
          ),
        ],
      ),
    ],
  );

  final initializationSettings = InitializationSettings(
    android: initializationSettingsAndroid,
    iOS: initializationSettingsIOS,
  );

  await flutterLocalNotificationsPlugin.initialize(
    initializationSettings,
    onDidReceiveBackgroundNotificationResponse: notificationTapBackground,
  );

  runApp(const MyApp());
}

示例代码

下面是一个完整的示例代码，展示了如何使用 codenic_alarm 插件实现闹钟的调度、取消等操作。

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        body: Center(
          child: Wrap(
            children: [
              FilledButton(
                child: const Text('请求通知权限'),
                onPressed: () async {
                  if (Platform.isIOS)
                    await flutterLocalNotificationsPlugin
                        .resolvePlatformSpecificImplementation<IOSFlutterLocalNotificationsPlugin>()
                        ?.requestPermissions(
                          alert: true,
                          badge: true,
                          sound: true,
                        );
                  else if (Platform.isAndroid)
                    await flutterLocalNotificationsPlugin
                        .resolvePlatformSpecificImplementation<AndroidFlutterLocalNotificationsPlugin>()
                        ?.requestExactAlarmsPermission();
                },
              ),
              FilledButton(
                child: const Text('显示闹钟'),
                onPressed: () {
                  CodenicAlarm.instance.schedule(
                    delay: const Duration(seconds: 5),
                    alarmInfo: AlarmInfo(
                      id: 1,
                      title: '调查提醒',
                      content: '报告您的健康状况',
                    ),
                  );
                },
              ),
              FilledButton(
                child: const Text('检查是否有活动的闹钟'),
                onPressed: () async {
                  final alarm = await CodenicAlarm.instance.activeAlarm();

                  if (alarm == null) {
                    print('没有活动的闹钟');
                  } else {
                    print('活动的闹钟: ${alarm.title} ${alarm.content}');
                  }
                },
              ),
              FilledButton(
                child: const Text('隐藏闹钟'),
                onPressed: () {
                  CodenicAlarm.instance.dismissAlarm();
                },
              ),
              FilledButton(
                child: const Text('取消所有闹钟'),
                onPressed: () {
                  CodenicAlarm.instance.cancelAll();
                },
              ),
              FilledButton(
                onPressed: () async {
                  print('AAAA');
                  final notificationDetailsIOS = DarwinNotificationDetails(
                    presentBanner: true,
                    categoryIdentifier: 'demoCategory',
                    presentSound: true,
                    threadIdentifier: '1',
                    interruptionLevel: InterruptionLevel.critical,
                    presentAlert: true,
                    presentList: true,
                  );

                  await flutterLocalNotificationsPlugin.show(
                    1,
                    '调查提醒',
                    '(10:45PM 下次。长按以取消) 潜入您的问答问卷！',
                    NotificationDetails(
                      iOS: notificationDetailsIOS,
                    ),
                  );

                  print('AAAA2');
                },
                child: Text('发送通知'),
              ),
            ],
          ),
        ),
      ),
      builder: (context, child) {
        return child!;
      },
    );
  }
}

[@pragma](/user/pragma)('vm:entry-point')
void notificationTapBackground(NotificationResponse notificationResponse) {
  // 处理通知点击事件
}