[Android][API] AlarmManager 简析

概述

AlarmManager 提供对系统闹钟服务（或称为定时器服务）的访问接口，使用它既可以指定单次执行的定时任务，也可以指定重复运行的任务。当闹钟指定触发时间到达时，实际上是系统发出为这个闹钟注册的广播，因此我们需要实现一个针对特定闹钟事件的广播接口器(PendingIntent)。

注意

从API 19开始，AlarmManager的机制都是非准确传递，操作系统将会转换闹钟，来最小化唤醒和电池使用

常用方法

1. 设置一次性闹钟

void set(int type,long startTime,PendingIntent pi)

解析：
    type        :   备注1
    startTime   ：  闹钟执行时间
    pi          ：  响应事件

2. 周期性执行的定时服务

void setRepeating(int type,long startTime,long intervalTime,PendingIntent pi)

解析：
    type        :   备注1
    startTime   ：  闹钟执行时间
    intervalTime:   间隔事件（可使用内部定义值 见备注2） 
    pi          ：  响应事件

3. 周期性执行的定时服务

void setInexactRepeating(int type,long startTime,long intervalTime,PendingIntent pi)

解析：
    type        :   备注1
    startTime   ：  闹钟执行时间
    intervalTime:   间隔事件（可使用内部定义值 见备注2） 
    pi          ：  响应事件

说明：
    与第二个方法相似，不过其两个闹钟执行的间隔时间不是固定的而已。它相对而言更省电（power-efficient）一些，因为系统可能会将几个差不多的闹钟合并为一个来执行，减少设备的唤醒次数

4. 取消定时服务

void cancel(PendingIntent pi)

说明：
    取消和PendingIntent配置的闹钟服务

个人观点：
    个人任务取消的应该和PendingIntent 的requestCode 参数有关。
    例如：PendingIntent.getBroadcast(Context context, int requestCode, Intent intent, @Flags int flags) 

备注

备注 1

• AlarmManager.ELAPSED_REALTIME
  在指定的延时过后，发送广播，但不唤醒设备（闹钟在睡眠状态下不可用）。如果在系统休眠时闹钟触发，它将不会被传递，直到下一次设备唤醒。
• AlarmManager.ELAPSED_REALTIME_WAKEUP
  在指定的延时过后，发送广播，并唤醒设备（即使关机也会执行operation所对应的组件） 。
  延时是要把系统启动的时间SystemClock.elapsedRealtime()算进去的，具体用法看代码。
• AlarmManager.RTC
  指定当系统调用System.currentTimeMillis()方法返回的值与triggerAtTime相等时启动operation所对应的设备（在指定的时刻，发送广播，但不唤醒设备）。如果在系统休眠时闹钟触发，它将不会被传递，直到下一次设备唤醒（闹钟在睡眠状态下不可用）。
• AlarmManager.RTC_WAKEUP
  指定当系统调用System.currentTimeMillis()方法返回的值与triggerAtTime相等时启动operation所对应的设备（在指定的时刻，发送广播，并唤醒设备）

备注 2

• AlarmManager.INTERVAL_FIFTEEN_MINUTES 间隔15分钟
• AlarmManager.INTERVAL_HALF_HOUR 间隔半个小时
• AlarmManager.INTERVAL_HOUR 间隔一个小时
• AlarmManager.INTERVAL_HALF_DAY 间隔半天
• AlarmManager.INTERVAL_DAY 间隔一天

---

FAQ

Q1. 设定多个定时闹钟为什么只有最后一个生效

A： AlarmManager 根据 PendingIntent requestCode 来判断是否是同一个定时服务，所以当
requestCode相等的时候只有最后一个生效

1. 我们说的requestCode 是第二个参数

PendingIntent.getBroadcast(Context context, int requestCode, Intent intent, @Flags int flags)

2. 例如：

PendingIntent pi1 = PendingIntent.getBroadcast(this, 1, intent, 0); 
AlarmManager.setRepeating(AlarmManager.RTC_WAKEUP, startTime, intervalTime, pi1);  

PendingIntent pi2 = PendingIntent.getBroadcast(this, 2, intent, 0); 
AlarmManager.setRepeating(AlarmManager.RTC_WAKEUP, startTime, intervalTime, pi2); 

这个样子就可以设定2个了