AlarmManager實質是一個全局的定時器,是Android中常用的一種系統級別的提示服務,在指定時間或周期性啟動其它組件(包括Activity,Service,BroadcastReceiver)。
概述:
該類提供一種訪問系統鬧鍾服務的方式,允許你去設置在將來的某個時間點去執行你的應用程序。當你的鬧鍾響起(時間到)時,在它上面注冊的一個意圖(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: 設置鬧鍾,間隔一個小時