AlarmManager实质是一个全局的定时器,是Android中经常使用的一种系统级别的提示服务,在指定时间或周期性启动其他组件(包含Activity,Service,BroadcastReceiver)。
概述:
该类提供一种訪问系统闹钟服务的方式,同意你去设置在将来的某个时间点去执行你的应用程序。
当你的闹钟响起(时间到)时。在它上面注冊的一个意图(Intent)将会被系统以广播发出,然后自己主动启动目标程序,假设它没有正在执行。
注冊的闹钟会被保留即使设备处于休眠中(假设闹钟在给定时间响起能够选择是否唤醒设备)。
假设闹钟关闭或者重新启动,闹钟将被清除。
仅仅要广播的onReceive()方法正在运行。这闹钟管理者(AlarmManager)会持有一个CPU唤醒锁,这是为了保证手机不会休眠直到处理完该广播。一旦onReceive()返回,那么闹钟管理者将会释放唤醒锁。这意味着仅仅要OnReceive()方法完毕。你的手机可能在某些情况下进入休眠。假设你的闹钟广播接收者调用的是Context.startService(),那么手机有可能在被请求的服务运行之前进入休眠。为了防止这样的情况,你的BroadcastReceiver和服务须要实现一个单独的唤醒锁策略以确保手机继续运行。直到服务可用。
注:该类适用于你想让应用程序在将来某个指定时间点执行的情况,即使你的应用程序如今没有执行。
对一般的时间操作。使用Handler是更easy和更有效率的。
公有方法:
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: 设置闹钟。间隔一个小时