1、AlarmManager,顧名思義,就是“提醒”,是Android中常用的一種系統級別的提示服務,可以實現從指定時間開始,以一個固定的間隔時間執行某項操作,所以常常與廣播(Broadcast)連用,實現鬧鍾等提示功能
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)方法。如果這三種方法錯用了的話,雖然不會報錯,但是看不到鬧鍾提示效果。
4、 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組件顯示
public void onReceive(Context context,Intent intent){ String msg = intent.getStringExtra("msg"); Toast.makeText(context,msg,Toast.LENGTH_SHORT).show(); }
第二步:在AndroidManifest.xml中注冊廣播接收類MyReceiver.java,設置其action值為“MYALARMRECEIVER”
<receiver android:name=".MyReceiver"> <intent-filter> <action android:name="MYALARMRECEIVER" /> </intent-filter> </receiver>
第三步:創建SendActivity.java,用於設置鬧鍾,定時發出廣播
//創建Intent對象,action指向廣播接收類,附加信息為字符串“你該打醬油了” Intent intent = new Intent("MYALARMRECEIVER"); intent.putExtra("msg","你該打醬油了"); //創建PendingIntent對象封裝Intent,由於是使用廣播,注意使用getBroadcast方法 PendingIntent pi = PendingIntent.getBroadcast(this,0,intent,0); //獲取AlarmManager對象 AlarmManager am = (AlarmManager)getSystemService(ALARM_SERVICE); //設置鬧鍾從當前時間開始,每隔10分鍾執行一次PendingIntent對象,注意第一個參數與第二個參數的關系 am.setRepeating(AlarmManager.RTC_WAKEUP,System.currentMillis(),600*1000,pi);
第四步:在AndroidManifest中為SendActivity.java注冊
<activity android:name=".SendActivity" />