Android中的定時器AlarmManager

remotesupport發表於2014-11-18

在Android上常用的定時器有兩種,一種是Java.util.Timer,一種就是系統的AlarmService

AlarmManager的作用文件中的解釋是:在特定的時刻為我們廣播一個指定的Intent。簡單的說就是我們設定一個時間,然後在該時間到來時,AlarmManager為我們廣播一個我們設定的Intent,常用方法有五個:
(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):在反覆執行一個task的計劃時,每一次 執行這個task的計劃執行時間在最初就被定下來了,也就是scheduledExecutionTime(第n次)=firstExecuteTime +n*periodTime;如果第n次執行task時,由於某種原因這次執行時間過長,執行完後的systemCurrentTime>= scheduledExecutionTime(第n+1次),則此時不做period間隔等待,立即執行第n+1次task,而接下來的第n+2次的 task的scheduledExecutionTime(第n+2次)依然還是firstExecuteTime+(n+2)*periodTime這 在第一次執行task就定下來了。說白了,這個方法更注重保持執行頻率的穩定。

(3)setInexactRepeating(int type,long startTime,long intervalTime,PendingIntent pi)
        該方法也用於設定重複鬧鐘,與第二個方法相似,不過其兩個鬧鐘執行的間隔時間不是固定的而已。它相對而言更節能(power-efficient)一些,因為系統可能會將幾個差不多的鬧鐘合併為一個來執行,減少裝置的喚醒次數。 有點類似JAVA的Timer裡面schedule(TimerTask task, Date firstTime, long period):在反覆執行一個task的計劃時,每一次執行這個task的計劃執行時間隨著前一次的實際執行時間而變,也就是 scheduledExecutionTime(第n+1次)=realExecutionTime(第n次)+periodTime。也就是說如果第n 次執行task時,由於某種原因這次執行時間過長,執行完後的systemCurrentTime>= scheduledExecutionTime(第n+1次),則此時不做時隔等待,立即執行第n+1次task,而接下來的第n+2次task的 scheduledExecutionTime(第n+2次)就隨著變成了realExecutionTime(第n+1次)+periodTime。說 白了,這個方法更注重保持間隔時間的穩定。

(4)cancel(PendingIntent operation)
       取消一個設定的鬧鐘

(5)setTimeZone(String timeZone)
       設定系統的預設時區。需要android.permission.SET_TIME_ZONE許可權

 

三個方法各個引數:
(1)int type:鬧鐘的型別,常用的有5個值:  

[java] view plaincopy
  1. AlarmManager.ELAPSED_REALTIME  
  2. AlarmManager.ELAPSED_REALTIME_WAKEUP  
  3. AlarmManager.RTC  
  4. AlarmManager.RTC_WAKEUP  
  5. AlarmManager.POWER_OFF_WAKEUP  


        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元件顯示

[java] view plaincopy
  1. public void onReceive(Context context,Intent intent){  
  2.      String msg = intent.getStringExtra("msg");  
  3.      Toast.makeText(context,msg,Toast.LENGTH_SHORT).show();  
  4. }  


建立SendActivity.java,用於設定鬧鐘,定時發出廣播

[java] view plaincopy
  1. //建立Intent物件,action指向廣播接收類,附加資訊為字串“你該打醬油了”  
  2.   
  3. Intent intent = new Intent("MYALARMRECEIVER");  
  4.   
  5. intent.putExtra("msg","你該打醬油了");  
  6.   
  7. //建立PendingIntent物件封裝Intent,由於是使用廣播,注意使用getBroadcast方法  
  8.   
  9. PendingIntent pi = PendingIntent.getBroadcast(this,0,intent,0);  
  10.   
  11. //獲取AlarmManager物件  
  12.   
  13. AlarmManager am = (AlarmManager)getSystemService(ALARM_SERVICE);  
  14.   
  15. //設定鬧鐘從當前時間開始,每隔10分鐘執行一次PendingIntent物件,注意第一個引數與第二個引數的關係  
  16.   
  17. am.setRepeating(AlarmManager.RTC_WAKEUP,System.currentMillis(),600*1000,pi);  


有時候,也許我們需要同時開啟多個定時器,我們先來看看下面這段程式碼:

[java] view plaincopy
  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之類的,(如果系統需要多個定時器的話)。

相關文章