Android中AlarmManager的几个重要方法详解

原创 2017年01月03日 20:03:59

一、概述:

该类提供一种访问系统闹钟服务的方式,允许你去设置在将来的某个时间点去执行你的应用程序。当你的闹钟响起(时间到)时,在它上面注册的一个意图(Intent)将会被系统以广播发出,然后自动启动目标程序,如果它没有正在运行。注册的闹钟会被保留即使设备处于休眠中(如果闹钟在给定时间响起可以选择是否唤醒设备)。如果闹钟关闭或者重启,闹钟将被清除。

只要广播的onReceive()方法正在执行,这闹钟管理者(AlarmManager)会持有一个CPU唤醒锁,这是为了保证手机不会休眠直到处理完该广播,一旦onReceive()返回,那么闹钟管理者将会释放唤醒锁。这意味着只要OnReceive()方法完成,你的手机可能在某些情况下进入休眠,如果你的闹钟广播接收者调用的是Context.startService(),那么手机有可能在被请求的服务执行之前进入休眠,为了防止这种情况,你的BroadcastReceiver和服务需要实现一个单独的唤醒锁策略以确保手机继续运行,直到服务可用。

此处注意:该类适用于你想让应用程序在将来某个指定时间点执行的情况,即使你的应用程序现在没有运行。对一般的时间操作,使用Handler是更容易和更有效率的

二、公有方法(Public Methods):

void cancel(PendingIntent operation)

取消AlarmManager的定时服务。

void set(int type, long triggerAtTime, PendingIntent operation)

设置在triggerAtTime时间启动由operation参数指定的组件。(该方法用于设置一次性闹钟)

void setInexactRepeating(int type, long triggerAtTime, long interval, PendingIntent operation)

设置一个非精确的周期性任务。

void setRepeating(int type, long triggerAtTime, long interval, PendingIntent operation)

设置一个周期性执行的定时服务。

void setTime(long millis)

设置系统“墙”时钟。需要android.permission.SET_TIME.权限。

void setTimeZone(String timeZone)

设置系统的默认时区。需要android.permission.SET_TIME_ZONE.权限。

三、常用方法说明:
AlarmManager的常用方法有三个:

(1)

set(int type,long startTime,PendingIntent pi)

该方法用于设置一次性闹钟。
第一个参数int type指定定时服务的类型,该参数接受如下值:

ELAPSED_REALTIME: 在指定的延时过后,发送广播,但不唤醒设备(闹钟在睡眠状态下不可用)。如果在系统休眠时闹钟触发,它将不会被传递,直到下一次设备唤醒。

ELAPSED_REALTIME_WAKEUP: 在指定的延时过后,发送广播,并唤醒设备(即使关机也会执行operation所对应的组件) 。
延时是要把系统启动的时间SystemClock.elapsedRealtime()算进去的,具体用法看代码。

RTC: 指定当系统调用System.currentTimeMillis()方法返回的值与triggerAtTime相等时启动operation所对应的设备(在指定的时刻,发送广播,但不唤醒设备)。如果在系统休眠时闹钟触发,它将不会被传递,直到下一次设备唤醒(闹钟在睡眠状态下不可用)。

RTC_WAKEUP: 指定当系统调用System.currentTimeMillis()方法返回的值与triggerAtTime相等时启动operation所对应的设备(在指定的时刻,发送广播,并唤醒设备)。即使系统关机也会执行 operation所对应的组件。

第二个参数表示闹钟执行时间。

第三个参数PendingIntent pi表示闹钟响应动作:

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

(2)

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

设置一个周期性执行的定时服务。第一个参数表示闹钟类型,第二个参数表示闹钟首次执行时间,第三个参数表示闹钟两次执行的间隔时间,第三个参数表示闹钟响应动作。

(3)

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

该方法也用于设置重复闹钟,与第二个方法相似,不过其两个闹钟执行的间隔时间不是固定的而已。它相对而言更省电(power-efficient)一些,因为系统可能会将几个差不多的闹钟合并为一个来执行,减少设备的唤醒次数。第三个参数intervalTime为闹钟间隔,内置的几个变量如下:

INTERVAL_DAY:      设置闹钟,间隔一天
INTERVAL_HALF_DAY:  设置闹钟,间隔半天
INTERVAL_FIFTEEN_MINUTES:设置闹钟,间隔15分钟
INTERVAL_HALF_HOUR:     设置闹钟,间隔半个小时
INTERVAL_HOUR:  设置闹钟,间隔一个小时

参考:http://yh.512876.com/diannao/276.html

1、AlarmManager,顾名思义,就是“提醒”,是Android中常用的一种系统级别的提示服务,在特定的时刻为我们广播一个指定的Intent。简单的说就是我们设定一个时间,然后在该时间到来时,AlarmManager为我们广播一个我们设定的Intent,通常我们使用 PendingIntent,PendingIntent可以理解为Intent的封装包,简单的说就是在Intent上在加个指定的动作。在使用Intent的时候,我们还需要在执行startActivity、startService或sendBroadcast才能使Intent有用。而PendingIntent的话就是将这个动作包含在内了。

  定义一个PendingIntent对象。

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

  2、AlarmManager的常用方法有三个:

  (1)set(int type,long startTime,PendingIntent pi);

  该方法用于设置一次性闹钟,第一个参数表示闹钟类型,第二个参数表示闹钟执行时间,第三个参数表示闹钟响应动作。

  (2)setRepeating(int type,long startTime,long intervalTime,PendingIntent pi);

  该方法用于设置重复闹钟,第一个参数表示闹钟类型,第二个参数表示闹钟首次执行时间,第三个参数表示闹钟两次执行的间隔时间,第三个参数表示闹钟响应动作。

  (3)setInexactRepeating(int type,long startTime,long intervalTime,PendingIntent pi);

  该方法也用于设置重复闹钟,与第二个方法相似,不过其两个闹钟执行的间隔时间不是固定的而已。

  3、三个方法各个参数详悉:

  (1)int type: 闹钟的类型,常用的有5个值:AlarmManager.ELAPSED_REALTIME、 AlarmManager.ELAPSED_REALTIME_WAKEUP、AlarmManager.RTC、 AlarmManager.RTC_WAKEUP、AlarmManager.POWER_OFF_WAKEUP。

  AlarmManager.ELAPSED_REALTIME表示闹钟在手机睡眠状态下不可用,该状态下闹钟使用相对时间(相对于系统启动开始),状态值为3;

  AlarmManager.ELAPSED_REALTIME_WAKEUP表示闹钟在睡眠状态下会唤醒系统并执行提示功能,该状态下闹钟也使用相对时间,状态值为2;

  AlarmManager.RTC表示闹钟在睡眠状态下不可用,该状态下闹钟使用绝对时间,即当前系统时间,状态值为1;

  AlarmManager.RTC_WAKEUP表示闹钟在睡眠状态下会唤醒系统并执行提示功能,该状态下闹钟使用绝对时间,状态值为0;

  AlarmManager.POWER_OFF_WAKEUP表示闹钟在手机关机状态下也能正常进行提示功能,所以是5个状态中用的最多的状态之一,该状态下闹钟也是用绝对时间,状态值为4;不过本状态好像受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)方法。如果这三种方法错用了的话,虽然不会报错,但是看不到闹钟提示效果。




版权声明:本文为博主原创文章,未经博主允许不得转载。

相关文章推荐

android按键事件和触屏事件(1)-几个重要方法的传递顺序

在工作中,用到了很多这方面的知识。希望这篇文章对大家有帮助。 Android中的事件类型分为按键事件和屏幕触摸事件,Touch事件是屏幕触摸事件的基础事件,有必要对它进行深入的了解。  一个最简单的...

线程的几个重要方法.doc

  • 2008年12月13日 08:31
  • 32KB
  • 下载

Android AlarmManager.set()方法参数相关

Android中的定时任务一般有2种实现方式:1.使用Java API里面的Timer类;2.使用Android的Alarm机制。 这两种方式在多数情况下都能实现类似的效果,但是Timer有一个明显...
  • xb_0226
  • xb_0226
  • 2016年04月14日 23:37
  • 2552

Android 定时操作方法AlarmManager,Timer,Handler

AlarmManager Timer有一个明显的短板,它并不太适用于那些需要长期在后台运行的定时任务。我们都知道,为了能让电池更加耐用,每种手机都会有自己的休眠策略,Android 手机就会在长时间不...

字符串String类在Java开发中常用的几个重要方法

Java中String类包含了50多个方法。令人惊讶的绝大多数的方法都很有用,在实际软件开发过程中用的频率也非常之多,下面我来总结最常用(最重要)的String类方法。 1.length(),返回值...
  • qian_ch
  • qian_ch
  • 2016年12月26日 13:08
  • 243

hibernate中的几个重要方法以及调用

Hibernate查询  首先介绍get()和load()方法的区别:  get()方法和load()方法的区别主要在于对二级缓存的使用上。  load()方法会使用二级缓存,而get()方法在...
  • klxmin
  • klxmin
  • 2012年05月15日 11:45
  • 1259

Canvas中的几个重要方法

Android中最重要的一个类当属Canvas了,所有View在UI上绘制全部是由Canvas实现的。而在使用SurfaceView的时候,对Canvas的使用就更重要了。     这里简单介绍下C...

Unity GameObject对象的几个重要方法

前端开发的认识就是学习对象的API方法。而不是像我们在在最开始学习C#语言一样,大部分都是自己实现的。很好的体现了面向对象的精髓。 在Unity开发中我们使用最多的对象,莫过于GameObject类...

javaweb学习笔记:Servlet的几个重要的方法

GenericServlet与HttpServlet类 1、GenericServlet是一个实现了Servlet的基本特征和功能的基类,其完整名称为javax.servlet.GenericS...

AbstractEditPart类中的几个重要方法的解析

1.refreshVisuals方法 默认情况下,方法 refreshVisuals() 仅在 EditPart 初始化的过程中调用一次,并且决不会被再次调用。在响应模型通知时,应该由程序员负责根据...
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:Android中AlarmManager的几个重要方法详解
举报原因:
原因补充:

(最多只允许输入30个字)