Android ApiDemos示例解析(19) App->Alarm->Alarm Controller

Alarm Controller演示如何在Android應用中使用Alarm事件，其功能和java.util.Timer ,TimerTask類似。但Alarm可以即使 當前應用退出後也可以做到Schedule一個任務在指定的時刻執行。

AlarmManager 用於管理Alarm事件，支持單次執行或 重復執行。 和大都數Android服務一樣，AlarmManager也是通過getSystemService來獲取服務對象：

AlarmManager am 

= (AlarmManager)getSystemService(ALARM_SERVICE);

與TimerTask對應的任務描述類型為PendingIntent， PendingIntent描述了將要執行的Intent，PendingIntent沒有提供構造函數，需要通過static 函數getActivity(Context, int, Intent, int), getBroadcast(Context, int, Intent, int), getService(Context, int, Intent, int) 來或得想要執行的 Activity，Broadcast，Service描述。

本例中是取得對Broadcast OneShotAlarm 和RepeatingAlarm的描述，分別對應於 單次執行時執行的Broadcast事件和多次執行時Broadcast事件，它們在AndroidManifest.xml定義為Broadcast Receiver：

<receiver android:name=”.app.OneShotAlarm” android:process=”:remote” />

<receiver android:name=”.app.RepeatingAlarm” android:process=”:remote” />

Schedule單次Alarm事件代碼如下：

Intent intent = new Intent(AlarmController.this, OneShotAlarm.class);     
PendingIntent sender = PendingIntent.getBroadcast(AlarmController.this,     
 0, intent, 0);     

// We want the alarm to go off 30 seconds from now.     
Calendar calendar = Calendar.getInstance();     
calendar.setTimeInMillis(System.currentTimeMillis());     
calendar.add(Calendar.SECOND, 30);     

// Schedule the alarm!     
AlarmManager am = (AlarmManager)getSystemService(ALARM_SERVICE);     
am.set(AlarmManager.RTC_WAKEUP, calendar.getTimeInMillis(), sender);

其中sender為對發給Broadcast Receiver  OneShotAlarm的Intent的描述，當到達指定的時間（例子中為30秒），AlarmManager將給OneShotAlarm發出一 個Broadcast Intent，OneShotAlarm接到後，將使用Toast在屏幕上顯示一個消息。 如果你多次點擊“One Shot Alarm”並不會 Schedule多個Alarm事件，這是因為Schedule同一個Sender對象，後一次將取消上此Scheduled的事件。