Android AlarmManager设置闹钟

官网镇楼：设置重复闹铃时间

闹钟具有以下特征：

• 它们可让您按设定的时间和/或间隔触发 intent。
• 您可以将它们与广播接收器结合使用，以启动服务以及执行其他操作。
• 它们在应用外部运行，因此即使应用未运行，或设备本身处于休眠状态，您也可以使用它们来触发事件或操作。
• 它们可以帮助您最大限度地降低应用的资源要求。您可以安排定期执行操作，而无需依赖定时器或持续运行后台服务

简单来说，要在设定的时间执行具体的任务，可以用 AlarmManager 来实现。

注：这里说的应用通过 AlarmManager 设置的闹钟 和 系统闹钟应用里设置的闹钟 不一样，不要混淆了。

举个例子，

应用通过 AlarmManager 设置闹钟，到某个时间点获取版本更新信息，简称 A 。

系统闹钟应用里设置的每天早上8点的起床闹钟，简称 B 。

添加 A 时，不会添加到系统闹钟应用里，触发 A 时 ，只会触发应用里的事件（如 Receiver），不会有系统闹钟的声音、震动、UI 弹窗等东西。

触发 B 时，有系统闹钟的声音、震动、UI 弹窗等东西。

初始化

AlarmManager alarmManager = (AlarmManager) getSystemService(ALARM_SERVICE);

设置单次闹钟

set

30s 后唤醒设备并触发闹钟

模拟器测试：

• 设置闹钟后不退出应用，锁屏，到时间可以触发，不会唤醒屏幕；
• 设置闹钟后退出应用，并清理进程，到时间可以触发；
• 设置闹钟后退出应用，并清理进程，锁屏，到时间可以触发，不会唤醒屏幕；

使用 PendingIntent 来实现，到时间后会触发 AlarmReceiver.onReceive() ，

Intent intent = new Intent(mContext, AlarmReceiver.class);
pendingIntent1 = PendingIntent.getBroadcast(mContext, 0, intent, 0);

alarmManager.set(AlarmManager.ELAPSED_REALTIME_WAKEUP,
            SystemClock.elapsedRealtime() + 30 * 1000,
            pendingIntent1);

setExact

setExact 和 set 用法是一样的，差别是 setExact 比 set 时间更精确。大白话，setExact 是 30 秒后触发，set 可能 30秒后触发，也可能 35 秒后触发。

30s 后唤醒设备并触发闹钟

Intent intent = new Intent(mContext, ExactAlarmReceiver.class);
pendingIntent6 = PendingIntent.getBroadcast(mContext, 6, intent, 0);

alarmManager.setExact(AlarmManager.ELAPSED_REALTIME_WAKEUP,
            SystemClock.elapsedRealtime() + 30 * 1000,
            pendingIntent6);

设置重复闹钟

设置重复闹钟用 setInexactRepeating 和 setRepeating 。

• setInexactRepeating ：必须使用指定的时间间隔常量，此方法会同步多个不精确的重复闹钟，并同时触发它们。这样可以减少耗电量。
• setRepeating ：精确闹钟，可以自定义时间间隔。

setInexactRepeating

使用 PendingIntent 和 Calendar 来实现，到时间后会触发 AlarmReceiver.onReceive() ，

在上午 10:10 左右唤醒设备并触发闹钟，

Calendar calendar = Calendar.getInstance();
calendar.setTimeInMillis(System.currentTimeMillis());
calendar.set(Calendar.HOUR_OF_DAY, 10);
calendar.set(Calendar.MINUTE, 10);

Intent intent = new Intent(mContext, AlarmReceiver.class);
pendingIntent3 = PendingIntent.getBroadcast(mContext, 0, intent, 0);

// With setInexactRepeating(), you have to use one of the AlarmManager interval
// constants--in this case, AlarmManager.INTERVAL_DAY.
alarmManager.setInexactRepeating(AlarmManager.RTC_WAKEUP, calendar.getTimeInMillis(),
            AlarmManager.INTERVAL_FIFTEEN_MINUTES, pendingIntent3);

指定的时间间隔有 15 分钟、半小时、一小时、半天、一天，分别对应 ：

• INTERVAL_FIFTEEN_MINUTES
• INTERVAL_HALF_HOUR
• INTERVAL_HOUR
• INTERVAL_HALF_DAY
• INTERVAL_DAY

setRepeating

使用 PendingIntent 和 Calendar 来实现，到时间后会触发 AlarmReceiver.onReceive() ，

在上午 9:25 准时唤醒设备并触发闹钟，此后每 1 分钟触发一次：

Intent intent = new Intent(mContext, AlarmReceiver.class);
pendingIntent4 = PendingIntent.getBroadcast(mContext, 0, intent, 0);

// Set the alarm to start at 9:25 a.m.
Calendar calendar = Calendar.getInstance();
calendar.setTimeInMillis(System.currentTimeMillis());
calendar.set(Calendar.HOUR_OF_DAY, 9);
calendar.set(Calendar.MINUTE, 25);

// setRepeating() lets you specify a precise custom interval--in this case,
// 1 minutes.
alarmManager.setRepeating(AlarmManager.RTC_WAKEUP, calendar.getTimeInMillis(),
            1000 * 60 * 1, pendingIntent4);

取消闹钟

使用 cancel() 方法，传入不想触发的 PendingIntent 即可。

if (alarmManager != null) {
   if (null != pendingIntent1) {
        alarmManager.cancel(pendingIntent1);
    }
    if (null != pendingIntent2) {
       alarmManager.cancel(pendingIntent2);
    }
    if (null != pendingIntent3) {
       alarmManager.cancel(pendingIntent3);
    }
  }

获取系统闹钟应用里设置的闹钟

获取系统闹钟应用里设置的闹钟，获取最临近的一个，返回一个 AlarmClockInfo ，

AlarmManager alarmManager = (AlarmManager) getSystemService(ALARM_SERVICE);
AlarmManager.AlarmClockInfo info = alarmManager.getNextAlarmClock();

AlarmClockInfo.getTriggerTime() 方法返回的是 UTC 时间，转为日期形式更直观，

/**
* 1692453600000 ==> Sat, 2023 08 19 22:00:00 GMT
* */
private String utc2Date(long utcTime){
    Calendar calendar= Calendar.getInstance();
    calendar.setTimeInMillis(utcTime);

    SimpleDateFormat sdfGmt = new SimpleDateFormat("EEE, yyyy MM d HH:mm:ss 'GMT'", Locale.getDefault());//星期三, 2023 08 16 22:00:00 GMT
    sdfGmt.setTimeZone(TimeZone.getDefault());
    return sdfGmt.format(calendar.getTime());
 }