在Android上常用的定时器 AlarmManager

AlarmManager的作用文档中的解释是：在特定的时刻为我们广播一个指定的Intent。简单的说就是我们设定一个时间，然后在该时间到来时，AlarmManager为我们广播一个我们设定的Intent，常用方法有五个：
(1)set(int type，long startTime，PendingIntent pi)；
        该方法用于设置一次性闹钟，第一个参数表示闹钟类型，第二个参数表示闹钟执行时间，第三个参数表示闹钟响应动作。
(2)setRepeating(int type，long startTime，long intervalTime，PendingIntent pi)；

        该方法用于设置重复闹钟，第一个参数表示闹钟类型，第二个参数表示闹钟首次执行时间，第三个参数表示闹钟两次执行的间隔时间，第四个参数表示闹钟响应动作。类似JAVA的Timer里面scheduleAtFixedRate(TimerTask task, long delay, long period)：在反复执行一个task的计划时，每一次 执行这个task的计划执行时间在最初就被定下来了，也就是scheduledExecutionTime(第n次)=firstExecuteTime +n*periodTime；如果第n次执行task时，由于某种原因这次执行时间过长，执行完后的systemCurrentTime>= scheduledExecutionTime(第n+1次)，则此时不做period间隔等待，立即执行第n+1次task，而接下来的第n+2次的 task的scheduledExecutionTime(第n+2次)依然还是firstExecuteTime+（n+2)*periodTime这 在第一次执行task就定下来了。说白了，这个方法更注重保持执行频率的稳定。

(3)setInexactRepeating（int type，long startTime，long intervalTime，PendingIntent pi）；
        该方法也用于设置重复闹钟，与第二个方法相似，不过其两个闹钟执行的间隔时间不是固定的而已。它相对而言更节能（power-efficient）一些，因为系统可能会将几个差不多的闹钟合并为一个来执行，减少设备的唤醒次数。 有点类似JAVA的Timer里面schedule(TimerTask task, Date firstTime, long period)：在反复执行一个task的计划时，每一次执行这个task的计划执行时间随着前一次的实际执行时间而变，也就是 scheduledExecutionTime(第n+1次)=realExecutionTime(第n次)+periodTime。也就是说如果第n 次执行task时，由于某种原因这次执行时间过长，执行完后的systemCurrentTime>= scheduledExecutionTime(第n+1次)，则此时不做时隔等待，立即执行第n+1次task，而接下来的第n+2次task的 scheduledExecutionTime(第n+2次)就随着变成了realExecutionTime(第n+1次)+periodTime。说 白了，这个方法更注重保持间隔时间的稳定。

(4)cancel(PendingIntent operation)
       取消一个设置的闹钟

(5)setTimeZone(String timeZone)
       设置系统的默认时区。需要android.permission.SET_TIME_ZONE权限

 

三个方法各个参数：
(1)int type：闹钟的类型，常用的有5个值：  

AlarmManager.ELAPSED_REALTIME
AlarmManager.ELAPSED_REALTIME_WAKEUP
AlarmManager.RTC
AlarmManager.RTC_WAKEUP
AlarmManager.POWER_OFF_WAKEUP

        AlarmManager.ELAPSED_REALTIME当系统进入睡眠状态时，这种类型的闹铃不会唤醒系统。直到系统下次被唤醒才传递它，该闹铃所用的时间是相对时间，是从系统启动后开始计时的,包括睡眠时间，可以通过调用SystemClock.elapsedRealtime()获得。系统值是3  (0x00000003)

        AlarmManager.ELAPSED_REALTIME_WAKEUP表示闹钟在睡眠状态下会唤醒系统并执行提示功能，该状态下闹钟也使用相对时间，用法同ELAPSED_REALTIME，系统值是2 (0x00000002)       

        AlarmManager.RTC表示闹钟在睡眠状态下，这种类型的闹铃不会唤醒系统。直到系统下次被唤醒才传递它，该闹铃所用的时间是绝对时间，所用时间是UTC时间，可以通过调用 System.currentTimeMillis()获得。系统值是1 (0x00000001)

        AlarmManager.RTC_WAKEUP表示闹钟在睡眠状态下会唤醒系统并执行提示功能，该状态下闹钟使用绝对时间，系统值为0(0x00000000)；
        AlarmManager.POWER_OFF_WAKEUP表示闹钟在手机关机状态下也能正常进行提示功能(关机闹钟)，所以是5个状态中用的最多的状态之一，该状态下闹钟也是用绝对时间，系统值为4(0x00000004)；不过本状态好像受SDK版本影响，某些版本并不支持；

(2)long startTime：

        闹钟的第一次执行时间，以毫秒为单位，可以自定义时间，不过一般使用当前时间。需要注意的是，本属性与第一个属性（type）密切相关，

        如果第一个参数对应的闹钟使用的是相对时间（ELAPSED_REALTIME和ELAPSED_REALTIME_WAKEUP），那么本属性就得使用相对时间（相对于系统启动时间来说），比如当前时间就表示为：SystemClock.elapsedRealtime()；

        如果第一个参数对应的闹钟使用的是绝对时间（RTC、RTC_WAKEUP、POWER_OFF_WAKEUP），那么本属性就得使用绝对时间，比如当前时间就表示为：System.currentTimeMillis()。

(3)long intervalTime：

        对于后两个方法来说，存在本属性，表示两次闹钟执行的间隔时间，也是以毫秒为单位。

(4)PendingIntent pi：

        是闹钟的执行动作，比如发送一个广播、给出提示等等。PendingIntent是Intent的封装类。需要注意的是，如果是通过启动服务来实现闹钟提示的话，PendingIntent对象的获取就应该采用Pending.getService(Context c,int i,Intent intent,int j)方法；如果是通过广播来实现闹钟提示的话，PendingIntent对象的获取就应该采用PendingIntent.getBroadcast(Context c,int i,Intent intent,int j)方法；如果是采用Activity的方式来实现闹钟提示的话，PendingIntent对象的获取就应该采用PendingIntent.getActivity(Context c,int i,Intent intent,int j)方法。如果这三种方法错用了的话，虽然不会报错，但是看不到闹钟提示效果。

 

AlarmManager使用示例：利用用户自定义广播实现闹钟功能，从当前时间开始，每隔10分钟提示一次

（1）实现原理：在SendActivity.java中定义一个AlarmManager对象，指定该对象从当前时间开始，每隔10分钟向名为“MYALARMRECEIVER”的广播接收器发出一条广播，附加消息内容为“你该打酱油了”；创建一个名为MyReceiver的广播接收器，在其onReceive方法中获取Intent对象传过来的值（“你该打酱油了”）并用一个Toast组件显示出来；在AndroidManifest.xml文件中注册SendActivity类和广播接收器类MyReceiver，设置MyReceiver的action的值为“MYALARMRECEIVER”

（2）代码实现：

创建广播接收类MyReceiver.java，在其onReceive方法中获取Intent的附加信息msg，并用Toast组件显示

public void onReceive(Context context,Intent intent){
     String msg = intent.getStringExtra("msg");
     Toast.makeText(context,msg,Toast.LENGTH_SHORT).show();
}

创建SendActivity.java，用于设置闹钟，定时发出广播

//创建Intent对象，action指向广播接收类，附加信息为字符串“你该打酱油了”

Intent intent = new Intent("MYALARMRECEIVER");

intent.putExtra("msg","你该打酱油了");

//创建PendingIntent对象封装Intent，由于是使用广播，注意使用getBroadcast方法

PendingIntent pi = PendingIntent.getBroadcast(this,0,intent,0);

//获取AlarmManager对象

AlarmManager am = (AlarmManager)getSystemService(ALARM_SERVICE);

//设置闹钟从当前时间开始，每隔10分钟执行一次PendingIntent对象，注意第一个参数与第二个参数的关系

am.setRepeating(AlarmManager.RTC_WAKEUP,System.currentMillis(),600*1000,pi);

有时候，也许我们需要同时开启多个定时器，我们先来看看下面这段代码：

AlarmManager am = null;
am = (AlarmManager) context.getApplicationContext().getSystemService(Context.ALARM_SERVICE);
for (int i = 0; i < 10; i ++) {
    ...
    Intent i = new Intent("xxx");
    PendingIntent sender = PendingIntent.getBroadcast(context.getApplicationContext(), 0, i, PendingIntent.FLAG_UPDATE_CURRENT);
    ...
    am.setRepeating(...);
}

如果采用这种做法后面的定时器会将前面的定时器"覆盖"掉，只会启动最后一个定时器

解决办法

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

第二个参数requestCode一定要是唯一的，比如不同的ID之类的，(如果系统需要多个定时器的话)。

例如如下：

public static PendingIntent sender1;
public static PendingIntent sender2;
Intent intent=new Intent(this,ShowUtil.class);
sender1=PendingIntent.getBroadcast(this, 1, intent, 0);//第二个参数，用来标识不同的send
sender2=PendingIntent.getBroadcast(this, 2, intent, 0);
AlarmManager alarm=(AlarmManager)getSystemService(ALARM_SERVICE);
alarm.setRepeating(AlarmManager.RTC_WAKEUP, System.currentTimeMillis(), 2*1000, sender1);
alarm.setRepeating(AlarmManager.RTC_WAKEUP, System.currentTimeMillis(), 5*1000, sender2);
//在其他地方
AlarmManager alarm=(AlarmManager)getSystemService(ALARM_SERVICE);
alarm.cancel(**.sender1);
alarm.cancel(**.sender2);