1、AlarmManager,顧名思義,就是“提醒”,是Android中常用的一種系統(tǒng)級(jí)別的提示服務(wù),在特定的時(shí)刻為我們廣播一個(gè)指定的Intent。簡(jiǎn)單的說(shuō)就是我們?cè)O(shè)定一個(gè)時(shí)間,然后在該時(shí)間到來(lái)時(shí),AlarmManager為我們廣播一個(gè)我們?cè)O(shè)定的Intent,通常我們使用 PendingIntent,PendingIntent可以理解為Intent的封裝包,簡(jiǎn)單的說(shuō)就是在Intent上在加個(gè)指定的動(dòng)作。在使用Intent的時(shí)候,我們還需要在執(zhí)行startActivity、startService或sendBroadcast才能使Intent有用。而PendingIntent的話(huà)就是將這個(gè)動(dòng)作包含在內(nèi)了。
定義一個(gè)PendingIntent對(duì)象。
PendingIntent pi = PendingIntent.getBroadcast(this,0,intent,0);
2、AlarmManager的常用方法有三個(gè):
(1)set(int type,long startTime,PendingIntent pi);
該方法用于設(shè)置一次性鬧鐘,第一個(gè)參數(shù)表示鬧鐘類(lèi)型,第二個(gè)參數(shù)表示鬧鐘執(zhí)行時(shí)間,第三個(gè)參數(shù)表示鬧鐘響應(yīng)動(dòng)作。
(2)setRepeating(int type,long startTime,long intervalTime,PendingIntent pi);
該方法用于設(shè)置重復(fù)鬧鐘,第一個(gè)參數(shù)表示鬧鐘類(lèi)型,第二個(gè)參數(shù)表示鬧鐘首次執(zhí)行時(shí)間,第三個(gè)參數(shù)表示鬧鐘兩次執(zhí)行的間隔時(shí)間,第三個(gè)參數(shù)表示鬧鐘響應(yīng)動(dòng)作。
(3)setInexactRepeating(int type,long startTime,long intervalTime,PendingIntent pi);
該方法也用于設(shè)置重復(fù)鬧鐘,與第二個(gè)方法相似,不過(guò)其兩個(gè)鬧鐘執(zhí)行的間隔時(shí)間不是固定的而已。
3、三個(gè)方法各個(gè)參數(shù)詳悉:
(1)int type: 鬧鐘的類(lèi)型,常用的有5個(gè)值:AlarmManager.ELAPSED_REALTIME、 AlarmManager.ELAPSED_REALTIME_WAKEUP、AlarmManager.RTC、 AlarmManager.RTC_WAKEUP、AlarmManager.POWER_OFF_WAKEUP。
AlarmManager.ELAPSED_REALTIME表示鬧鐘在手機(jī)睡眠狀態(tài)下不可用,該狀態(tài)下鬧鐘使用相對(duì)時(shí)間(相對(duì)于系統(tǒng)啟動(dòng)開(kāi)始),狀態(tài)值為3;
AlarmManager.ELAPSED_REALTIME_WAKEUP表示鬧鐘在睡眠狀態(tài)下會(huì)喚醒系統(tǒng)并執(zhí)行提示功能,該狀態(tài)下鬧鐘也使用相對(duì)時(shí)間,狀態(tài)值為2;
AlarmManager.RTC表示鬧鐘在睡眠狀態(tài)下不可用,該狀態(tài)下鬧鐘使用絕對(duì)時(shí)間,即當(dāng)前系統(tǒng)時(shí)間,狀態(tài)值為1;
AlarmManager.RTC_WAKEUP表示鬧鐘在睡眠狀態(tài)下會(huì)喚醒系統(tǒng)并執(zhí)行提示功能,該狀態(tài)下鬧鐘使用絕對(duì)時(shí)間,狀態(tài)值為0;
AlarmManager.POWER_OFF_WAKEUP表示鬧鐘在手機(jī)關(guān)機(jī)狀態(tài)下也能正常進(jìn)行提示功能,所以是5個(gè)狀態(tài)中用的最多的狀態(tài)之一,該狀態(tài)下鬧鐘也是用絕對(duì)時(shí)間,狀態(tài)值為4;不過(guò)本狀態(tài)好像受SDK版本影響,某些版本并不支持;
(2)long startTime: 鬧鐘的第一次執(zhí)行時(shí)間,以毫秒為單位,可以自定義時(shí)間,不過(guò)一般使用當(dāng)前時(shí)間。需要注意的是,本屬性與第一個(gè)屬性(type)密切相關(guān),如果第一個(gè)參數(shù)對(duì) 應(yīng)的鬧鐘使用的是相對(duì)時(shí)間(ELAPSED_REALTIME和ELAPSED_REALTIME_WAKEUP),那么本屬性就得使用相對(duì)時(shí)間(相對(duì)于 系統(tǒng)啟動(dòng)時(shí)間來(lái)說(shuō)),比如當(dāng)前時(shí)間就表示為:SystemClock.elapsedRealtime();如果第一個(gè)參數(shù)對(duì)應(yīng)的鬧鐘使用的是絕對(duì)時(shí)間 (RTC、RTC_WAKEUP、POWER_OFF_WAKEUP),那么本屬性就得使用絕對(duì)時(shí)間,比如當(dāng)前時(shí)間就表示 為:System.currentTimeMillis()。
(3)long intervalTime:對(duì)于后兩個(gè)方法來(lái)說(shuō),存在本屬性,表示兩次鬧鐘執(zhí)行的間隔時(shí)間,也是以毫秒為單位。
(4)PendingIntent pi: 綁定了鬧鐘的執(zhí)行動(dòng)作,比如發(fā)送一個(gè)廣播、給出提示等等。PendingIntent是Intent的封裝類(lèi)。需要注意的是,如果是通過(guò)啟動(dòng)服務(wù)來(lái)實(shí)現(xiàn)鬧鐘提 示的話(huà),PendingIntent對(duì)象的獲取就應(yīng)該采用Pending.getService(Context c,int i,Intent intent,int j)方法;如果是通過(guò)廣播來(lái)實(shí)現(xiàn)鬧鐘提示的話(huà),PendingIntent對(duì)象的獲取就應(yīng)該采用 PendingIntent.getBroadcast(Context c,int i,Intent intent,int j)方法;如果是采用Activity的方式來(lái)實(shí)現(xiàn)鬧鐘提示的話(huà),PendingIntent對(duì)象的獲取就應(yīng)該采用 PendingIntent.getActivity(Context c,int i,Intent intent,int j)方法。如果這三種方法錯(cuò)用了的話(huà),雖然不會(huì)報(bào)錯(cuò),但是看不到鬧鐘提示效果。
4.舉例說(shuō)明:定義一個(gè)鬧鐘,5秒鐘重復(fù)響應(yīng)。
(1)MainActivity,在onCreate中完成:
//創(chuàng)建Intent對(duì)象,action為ELITOR_CLOCK,附加信息為字符串“你該打醬油了”
Intent intent = new Intent("ELITOR_CLOCK");
intent.putExtra("msg","你該打醬油了");
//定義一個(gè)PendingIntent對(duì)象,PendingIntent.getBroadcast包含了sendBroadcast的動(dòng)作。
//也就是發(fā)送了action 為"ELITOR_CLOCK"的intent
PendingIntent pi = PendingIntent.getBroadcast(this,0,intent,0);
//AlarmManager對(duì)象,注意這里并不是new一個(gè)對(duì)象,Alarmmanager為系統(tǒng)級(jí)服務(wù)
AlarmManager am = (AlarmManager)getSystemService(ALARM_SERVICE);
/設(shè)置鬧鐘從當(dāng)前時(shí)間開(kāi)始,每隔5s執(zhí)行一次PendingIntent對(duì)象pi,注意第一個(gè)參數(shù)與第二個(gè)參數(shù)的關(guān)系
// 5秒后通過(guò)PendingIntent pi對(duì)象發(fā)送廣播
am.setRepeating(AlarmManager.RTC_WAKEUP,System.currentTimeMillis(),5*1000,pi);
那么啟動(dòng)MainActivity之后,由于定義了AlarmManager am,并且調(diào)用了am.setRepeating(...)函數(shù),則系統(tǒng)每隔5s將會(huì)通過(guò)pi啟動(dòng)intent發(fā)送廣播,其action為ELITOR_CLOCK。所以我們需要在Manifest.xml中注冊(cè)一個(gè)receiver,同時(shí)自己定義一個(gè)廣播接收器類(lèi)。
(2)定義一個(gè)廣播接收器類(lèi)MyReceiver,重寫(xiě)onReceive()函數(shù)。
public class MyReceiver extends BroadcastReceiver
{
@Override
public void onReceive(Context context, Intent intent)
{
// TODO Auto-generated method stub
Log.d("MyTag", "onclock......................");
String msg = intent.getStringExtra("msg");
Toast.makeText(context,msg,Toast.LENGTH_SHORT).show();
}
}
(3)在Manifest.xml中注冊(cè)廣播接收器:
<receiver android:name=".MyReceiver">
<intent-filter>
<action android:name="ELITOR_CLOCK" />
</intent-filter>
</receiver>