Android中的AlarmManager的使用

標籤：android   github   

1、AlarmManager，顧名思義，就是“提醒”，是Android中常用的一種系統層級的提示服務，在特定的時刻為我們廣播一個指定的Intent。簡單的說就是我們設定一個時間，然後在該時間到來時，AlarmManager為我們廣播一個我們設定的Intent,通常我們使用 PendingIntent，PendingIntent可以理解為Intent的封裝包，簡單的說就是在Intent上在加個指定的動作。在使用Intent的時候，我們還需要在執行startActivity、startService或sendBroadcast才能使Intent有用。而PendingIntent的話就是將這個動作包含在內了。

定義一個PendingIntent對象。
PendingIntent pi = PendingIntent.getBroadcast(this,0,intent,0);

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)方法。如果這三種方法錯用了的話，雖然不會報錯，但是看不到鬧鐘提示效果。

第二個參數i 一定要是唯一的，比如不同的ID之類的，(如果系統需要多個定時器的話)。

例子代碼可以參考：

https://github.com/cayden/Alarm

Android中的AlarmManager的使用