ez_alarm 是一个用于 Flutter 应用的闹钟管理插件，它可以帮助开发者轻松地在应用中设置和管理闹钟。以下是如何使用 ez_alarm 插件的基本步骤：

1. 添加依赖

首先，你需要在 pubspec.yaml 文件中添加 ez_alarm 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  ez_alarm: ^0.1.0 # 请使用最新版本

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

2. 初始化插件

在你的 Dart 文件中导入 ez_alarm 插件，并在应用启动时初始化它：

import 'package:ez_alarm/ez_alarm.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await EzAlarm.initialize();
  runApp(MyApp());
}

3. 设置闹钟

你可以使用 EzAlarm.setAlarm 方法来设置闹钟。以下是一个简单的示例：

void setAlarm() async {
  DateTime alarmTime = DateTime.now().add(Duration(minutes: 1)); // 设置1分钟后响铃
  int alarmId = 1; // 闹钟的唯一ID
  String alarmTitle = "起床啦！";
  String alarmDescription = "该起床了，新的一天开始了！";
  bool vibrate = true;
  String sound = "alarm_sound.mp3"; // 可以是本地文件或默认声音

  await EzAlarm.setAlarm(
    id: alarmId,
    dateTime: alarmTime,
    title: alarmTitle,
    description: alarmDescription,
    vibrate: vibrate,
    sound: sound,
  );
}

4. 取消闹钟

你可以使用 EzAlarm.cancelAlarm 方法来取消已经设置的闹钟：

void cancelAlarm(int alarmId) async {
  await EzAlarm.cancelAlarm(alarmId);
}

5. 处理闹钟事件

你可以在应用中监听闹钟事件，例如当闹钟响起时执行某些操作。你可以使用 EzAlarm.onAlarm 来监听闹钟事件：

void setupAlarmListener() {
  EzAlarm.onAlarm((int alarmId) {
    print("闹钟 $alarmId 响了！");
    // 在这里处理闹钟响起后的逻辑
  });
}

6. 检查闹钟状态

你可以使用 EzAlarm.checkAlarm 方法来检查某个闹钟是否已经设置：

void checkAlarm(int alarmId) async {
  bool isAlarmSet = await EzAlarm.checkAlarm(alarmId);
  print("闹钟 $alarmId 是否已设置: $isAlarmSet");
}

7. 获取所有闹钟

你可以使用 EzAlarm.getAllAlarms 方法来获取所有已设置的闹钟：

void getAllAlarms() async {
  List<EzAlarmInfo> alarms = await EzAlarm.getAllAlarms();
  for (var alarm in alarms) {
    print("闹钟 ID: ${alarm.id}, 时间: ${alarm.dateTime}");
  }
}

8. 处理权限

在某些 Android 设备上，可能需要请求闹钟权限。你可以使用 EzAlarm.requestPermissions 方法来请求必要的权限：

void requestPermissions() async {
  bool granted = await EzAlarm.requestPermissions();
  if (granted) {
    print("权限已授予");
  } else {
    print("权限被拒绝");
  }
}

9. 处理通知

ez_alarm 插件通常会使用通知来提醒用户闹钟响起。你可以根据需要自定义通知的外观和行为。

10. 处理后台任务

如果应用在后台运行，ez_alarm 插件仍然可以正常触发闹钟。你可以使用 EzAlarm.onAlarm 来处理后台任务。

示例代码

以下是一个完整的示例代码，展示了如何使用 ez_alarm 插件设置和管理闹钟：

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await EzAlarm.initialize();
  runApp(MyApp());
}

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

class AlarmScreen extends StatefulWidget {
  [@override](/user/override)
  _AlarmScreenState createState() => _AlarmScreenState();
}

class _AlarmScreenState extends State<AlarmScreen> {
  int alarmId = 1;

  [@override](/user/override)
  void initState() {
    super.initState();
    setupAlarmListener();
  }

  void setupAlarmListener() {
    EzAlarm.onAlarm((int alarmId) {
      print("闹钟 $alarmId 响了！");
      // 在这里处理闹钟响起后的逻辑
    });
  }

  void setAlarm() async {
    DateTime alarmTime = DateTime.now().add(Duration(minutes: 1));
    await EzAlarm.setAlarm(
      id: alarmId,
      dateTime: alarmTime,
      title: "起床啦！",
      description: "该起床了，新的一天开始了！",
      vibrate: true,
      sound: "alarm_sound.mp3",
    );
  }

  void cancelAlarm() async {
    await EzAlarm.cancelAlarm(alarmId);
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('闹钟示例'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            ElevatedButton(
              onPressed: setAlarm,
              child: Text('设置闹钟'),
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: cancelAlarm,
              child: Text('取消闹钟'),
            ),
          ],
        ),
      ),
    );
  }
}