定时器AlarmManager使用

时间:2022-08-24 00:11:09

转自:http://www.open-open.com/lib/view/open1350291466977.html

AlarmManager的作用文档中的解释是:在特定的时刻为我们广播一个指定的Intent。简单的说就是我们设定一个时间,然后在该时间到来时,AlarmManager为我们广播一个我们设定的Intent。

AlarmManager alarmManager = (AlarmManager)getSystemService(Context.ALARM_SERVICE);

常用方法有五个:
(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):以近似固定的时间间隔(由指定的周期分隔)进行后续执行。在固定速率执行中,根据已安排的初始执行时间来安排每次执行。如果由于任何原因(如垃圾回收或其他后台活动)而延迟了某次执行,则将快速连续地出现两次或更多的执行,从而使后续执行能够“追赶上来”。从长远来看,执行的频率将正好是指定周期的倒数(假定 Object.wait(long) 所依靠的系统时钟是准确的)。

(3)setInexactRepeating(int type,long startTime,long intervalTime,PendingIntent pi)
  该方法也用于设置重复闹钟,与第二个方法相似,不过其两个闹钟执行的间隔时间不是固定的而已。它相对而言更节能(power-efficient)一些,因为系统可能会将几个差不多的闹钟合并为一个来执行,减少设备的唤醒次数。 有点类似JAVA的Timer里面schedule(TimerTask task, Date firstTime, long period):根据前一次执行的实际执行时间来安排每次执行。如果由于任何原因(如垃圾回收或其他后台活动)而延迟了某次执行,则后续执行也将被延迟。在长期运行中,执行的频率一般要稍慢于指定周期的倒数(假定 Object.wait(long) 所依靠的系统时钟是准确的)。

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

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

 

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

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组件显示

   
   
  1. public void onReceive(Context context,Intent intent){
  2. String msg = intent.getStringExtra("msg");
  3. Toast.makeText(context,msg,Toast.LENGTH_SHORT).show();
  4. }
  5. 创建SendActivity.java,用于设置闹钟,定时发出广播
  6. //创建Intent对象,action指向广播接收类,附加信息为字符串“你该打酱油了”
  7. Intent intent = new Intent("MYALARMRECEIVER");
  8. intent.putExtra("msg","你该打酱油了");
  9. //创建PendingIntent对象封装Intent,由于是使用广播,注意使用getBroadcast方法
  10. PendingIntent pi = PendingIntent.getBroadcast(this,0,intent,0);
  11. //获取AlarmManager对象
  12. AlarmManager am = (AlarmManager)getSystemService(ALARM_SERVICE);
  13. //设置闹钟从当前时间开始,每隔10分钟执行一次PendingIntent对象,注意第一个参数与第二个参数的关系
  14. am.setRepeating(AlarmManager.RTC_WAKEUP,System.currentMillis(),600*1000,pi);


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

   
   
  1. AlarmManager am = null;
  2. am = (AlarmManager) context.getApplicationContext().getSystemService(Context.ALARM_SERVICE);
  3. for (int i = 0; i < 10; i ++) {
  4. ...
  5. Intent i = new Intent("xxx");
  6. PendingIntent sender = PendingIntent.getBroadcast(context.getApplicationContext(), 0, i, PendingIntent.FLAG_UPDATE_CURRENT);
  7. ...
  8. am.setRepeating(...);
  9. }

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

解决办法

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

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