Android中的AlarmManager實質(zhì)上是一個全局的定時器,是Android中常用的一種系統(tǒng)級別的提示服務(wù),在指定時間或周期性啟動其它組件(包括Activity,Service,BroadcastReceiver)。
一、概述:
該類提供一種訪問系統(tǒng)鬧鐘服務(wù)的方式,允許你去設(shè)置在將來的某個時間點去執(zhí)行你的應(yīng)用程序。當(dāng)你的鬧鐘響起(時間到)時,在它上面注冊的一個意圖(Intent)將會被系統(tǒng)以廣播發(fā)出,然后自動啟動目標(biāo)程序,如果它沒有正在運行。注冊的鬧鐘會被保留即使設(shè)備處于休眠中(如果鬧鐘在給定時間響起可以選擇是否喚醒設(shè)備)。如果鬧鐘關(guān)閉或者重啟,鬧鐘將被清除。
只要廣播的onReceive()方法正在執(zhí)行,這鬧鐘管理者(AlarmManager)會持有一個CPU喚醒鎖,這是為了保證手機不會休眠直到處理完該廣播,一旦onReceive()返回,那么鬧鐘管理者將會釋放喚醒鎖。這意味著只要OnReceive()方法完成,你的手機可能在某些情況下進入休眠,如果你的鬧鐘廣播接收者調(diào)用的是Context.startService(),那么手機有可能在被請求的服務(wù)執(zhí)行之前進入休眠,為了防止這種情況,你的BroadcastReceiver和服務(wù)需要實現(xiàn)一個單獨的喚醒鎖策略以確保手機繼續(xù)運行,直到服務(wù)可用。
此處注意:該類適用于你想讓應(yīng)用程序在將來某個指定時間點執(zhí)行的情況,即使你的應(yīng)用程序現(xiàn)在沒有運行。對一般的時間操作,使用Handler是更容易和更有效率的。
二、公有方法(Public Methods):
1
|
void cancel(PendingIntent operation) |
取消AlarmManager的定時服務(wù)。
1
|
void set( int type, long triggerAtTime, PendingIntent operation) |
設(shè)置在triggerAtTime時間啟動由operation參數(shù)指定的組件。(該方法用于設(shè)置一次性鬧鐘)
1
|
void setInexactRepeating( int type, long triggerAtTime, long interval, PendingIntent operation) |
設(shè)置一個非精確的周期性任務(wù)。
1
|
void setRepeating( int type, long triggerAtTime, long interval, PendingIntent operation) |
設(shè)置一個周期性執(zhí)行的定時服務(wù)。
1
|
void setTime( long millis) |
設(shè)置系統(tǒng)“墻”時鐘。需要android.permission.SET_TIME.權(quán)限。
1
|
void setTimeZone(String timeZone) |
設(shè)置系統(tǒng)的默認時區(qū)。需要android.permission.SET_TIME_ZONE.權(quán)限。
三、常用方法說明:
AlarmManager的常用方法有三個:
(1)
1
|
set( int type, long startTime,PendingIntent pi) |
該方法用于設(shè)置一次性鬧鐘。
第一個參數(shù)int type指定定時服務(wù)的類型,該參數(shù)接受如下值:
ELAPSED_REALTIME: 在指定的延時過后,發(fā)送廣播,但不喚醒設(shè)備(鬧鐘在睡眠狀態(tài)下不可用)。如果在系統(tǒng)休眠時鬧鐘觸發(fā),它將不會被傳遞,直到下一次設(shè)備喚醒。
ELAPSED_REALTIME_WAKEUP: 在指定的延時過后,發(fā)送廣播,并喚醒設(shè)備(即使關(guān)機也會執(zhí)行operation所對應(yīng)的組件) 。
延時是要把系統(tǒng)啟動的時間SystemClock.elapsedRealtime()算進去的,具體用法看代碼。
RTC: 指定當(dāng)系統(tǒng)調(diào)用System.currentTimeMillis()方法返回的值與triggerAtTime相等時啟動operation所對應(yīng)的設(shè)備(在指定的時刻,發(fā)送廣播,但不喚醒設(shè)備)。如果在系統(tǒng)休眠時鬧鐘觸發(fā),它將不會被傳遞,直到下一次設(shè)備喚醒(鬧鐘在睡眠狀態(tài)下不可用)。
RTC_WAKEUP: 指定當(dāng)系統(tǒng)調(diào)用System.currentTimeMillis()方法返回的值與triggerAtTime相等時啟動operation所對應(yīng)的設(shè)備(在指定的時刻,發(fā)送廣播,并喚醒設(shè)備)。即使系統(tǒng)關(guān)機也會執(zhí)行 operation所對應(yīng)的組件。
第二個參數(shù)表示鬧鐘執(zhí)行時間。
第三個參數(shù)PendingIntent pi表示鬧鐘響應(yīng)動作:
PendingIntent pi:是鬧鐘的執(zhí)行動作,比如發(fā)送一個廣播、給出提示等等。PendingIntent是Intent的封裝類。需要注意的是,如果是通過啟動服務(wù)來實現(xiàn)鬧鐘提示的話,PendingIntent對象的獲取就應(yīng)該采用Pending.getService(Context c,int i,Intentintent,int j)方法;如果是通過廣播來實現(xiàn)鬧鐘提示的話,PendingIntent對象的獲取就應(yīng)該采用PendingIntent.getBroadcast(Context c,inti,Intent intent,int j)方法;如果是采用Activity的方式來實現(xiàn)鬧鐘提示的話,PendingIntent對象的獲取就應(yīng)該采用PendingIntent.getActivity(Context c,inti,Intent intent,int j)方法。如果這三種方法錯用了的話,雖然不會報錯,但是看不到鬧鐘提示效果。
(2)
1
|
setRepeating( int type, long startTime, long intervalTime,PendingIntent pi) |
設(shè)置一個周期性執(zhí)行的定時服務(wù)。第一個參數(shù)表示鬧鐘類型,第二個參數(shù)表示鬧鐘首次執(zhí)行時間,第三個參數(shù)表示鬧鐘兩次執(zhí)行的間隔時間,第三個參數(shù)表示鬧鐘響應(yīng)動作。
(3)
1
|
setInexactRepeating( int type, long startTime, long intervalTime,PendingIntent pi) |
該方法也用于設(shè)置重復(fù)鬧鐘,與第二個方法相似,不過其兩個鬧鐘執(zhí)行的間隔時間不是固定的而已。它相對而言更省電(power-efficient)一些,因為系統(tǒng)可能會將幾個差不多的鬧鐘合并為一個來執(zhí)行,減少設(shè)備的喚醒次數(shù)。第三個參數(shù)intervalTime為鬧鐘間隔,內(nèi)置的幾個變量如下:
INTERVAL_DAY: 設(shè)置鬧鐘,間隔一天
INTERVAL_HALF_DAY: 設(shè)置鬧鐘,間隔半天
INTERVAL_FIFTEEN_MINUTES:設(shè)置鬧鐘,間隔15分鐘
INTERVAL_HALF_HOUR: 設(shè)置鬧鐘,間隔半個小時
INTERVAL_HOUR: 設(shè)置鬧鐘,間隔一個小時