AlarmManager(鬧鐘服務(wù))
本節(jié)引言:
本節(jié)帶來的Android中的AlarmManager(鬧鐘服務(wù)),聽名字我們知道可以通過它開發(fā)手機(jī)鬧鐘類的APP, 而在文檔中的解釋是:在特定的時刻為我們廣播一個指定的Intent,簡單說就是我們自己定一個時間, 然后當(dāng)?shù)綍r間時,AlarmManager會為我們廣播一個我們設(shè)定好的Intent,比如時間到了,可以指向某個 Activity或者Service!另外官方文檔中有一些要注意的地方:
另外要注意一點(diǎn)的是,AlarmManager主要是用來在某個時刻運(yùn)行你的代碼的,即時你的APP在那個特定 時間并沒有運(yùn)行!還有,從API 19開始,Alarm的機(jī)制都是非準(zhǔn)確傳遞的,操作系統(tǒng)將會轉(zhuǎn)換鬧鐘 ,來最小化喚醒和電池的使用!某些新的API會支持嚴(yán)格準(zhǔn)確的傳遞,見 setWindow(int, long, long, PendingIntent)和setExact(int, long, PendingIntent)。 targetSdkVersion在API 19之前應(yīng)用仍將繼續(xù)使用以前的行為,所有的鬧鐘在要求準(zhǔn)確傳遞的情況 下都會準(zhǔn)確傳遞。更多詳情可見官方API文檔:AlarmManager
1.Timer類與AlarmManager類區(qū)別:
如果你學(xué)過J2SE的話,那么你對Timer肯定不會陌生,定時器嘛,一般寫定時任務(wù)的時候 肯定離不開他,但是在Android里,他卻有個短板,不太適合那些需要長時間在后臺運(yùn)行的 定時任務(wù),因?yàn)锳ndroid設(shè)備有自己的休眠策略,當(dāng)長時間的無操作,設(shè)備會自動讓CPU進(jìn)入 休眠狀態(tài),這樣就可能導(dǎo)致Timer中的定時任務(wù)無法正常運(yùn)行!而AlarmManager則不存在 這種情況,因?yàn)樗哂袉拘袰PU的功能,可以保證每次需要執(zhí)行特定任務(wù)時CPU都能正常工作, 或者說當(dāng)CPU處于休眠時注冊的鬧鐘會被保留(可以喚醒CPU),但如果設(shè)備被關(guān)閉,或者重新 啟動的話,鬧鐘將被清除!(Android手機(jī)關(guān)機(jī)鬧鐘不響...)
2.獲得AlarmManager實(shí)例對象:
AlarmManager alarmManager = (AlarmManager) getSystemService(ALARM_SERVICE);
3.相關(guān)方法講解:
- set(int type,long startTime,PendingIntent pi):一次性鬧鐘
- setRepeating(int type,long startTime,long intervalTime,PendingIntent pi): 重復(fù)性鬧鐘,和3有區(qū)別,3鬧鐘間隔時間不固定
- setInexactRepeating(int type,long startTime,long intervalTime,PendingIntent pi): 重復(fù)性鬧鐘,時間不固定
- cancel(PendingIntent pi):取消AlarmManager的定時服務(wù)
- getNextAlarmClock():得到下一個鬧鐘,返回值A(chǔ)larmManager.AlarmClockInfo
- setAndAllowWhileIdle(int type, long triggerAtMillis, PendingIntent operation) 和set方法類似,這個鬧鐘運(yùn)行在系統(tǒng)處于低電模式時有效
- setExact(int type, long triggerAtMillis, PendingIntent operation): 在規(guī)定的時間精確的執(zhí)行鬧鐘,比set方法設(shè)置的精度更高
- setTime(long millis):設(shè)置系統(tǒng)墻上的時間
- setTimeZone(String timeZone):設(shè)置系統(tǒng)持續(xù)的默認(rèn)時區(qū)
- setWindow(int type, long windowStartMillis, long windowLengthMillis, PendingIntent operation): 設(shè)置一個鬧鐘在給定的時間窗觸發(fā)。類似于set,該方法允許應(yīng)用程序精確地控制操作系統(tǒng)調(diào) 整鬧鐘觸發(fā)時間的程度。
關(guān)鍵參數(shù)講解:
- Type(鬧鐘類型): 有五個可選值: AlarmManager.ELAPSED_REALTIME: 鬧鐘在手機(jī)睡眠狀態(tài)下不可用,該狀態(tài)下鬧鐘使用相對時間(相對于系統(tǒng)啟動開始),狀態(tài)值為3; AlarmManager.ELAPSED_REALTIME_WAKEUP鬧鐘在睡眠狀態(tài)下會喚醒系統(tǒng)并執(zhí)行提示功能,該狀態(tài)下鬧鐘也使用相對時間,狀態(tài)值為2; AlarmManager.RTC鬧鐘在睡眠狀態(tài)下不可用,該狀態(tài)下鬧鐘使用絕對時間,即當(dāng)前系統(tǒng)時間,狀態(tài)值為1; AlarmManager.RTC_WAKEUP表示鬧鐘在睡眠狀態(tài)下會喚醒系統(tǒng)并執(zhí)行提示功能,該狀態(tài)下鬧鐘使用絕對時間,狀態(tài)值為0; AlarmManager.POWER_OFF_WAKEUP表示鬧鐘在手機(jī)關(guān)機(jī)狀態(tài)下也能正常進(jìn)行提示功能,所以是5個狀態(tài)中用的最多的狀態(tài)之一,該狀態(tài)下鬧鐘也是用絕對時間,狀態(tài)值為4;不過本狀態(tài)好像受SDK版本影響,某些版本并不支持;
- startTime:鬧鐘的第一次執(zhí)行時間,以毫秒為單位,可以自定義時間,不過一般使用當(dāng)前時間。 需要注意的是,本屬性與第一個屬性(type)密切相關(guān),如果第一個參數(shù)對應(yīng)的鬧鐘使用的是相對時間 (ELAPSED_REALTIME和ELAPSED_REALTIME_WAKEUP),那么本屬性就得使用相對時間 (相對于系統(tǒng)啟動時間來說),比如當(dāng)前時間就表示為:SystemClock.elapsedRealtime(); 如果第一個參數(shù)對應(yīng)的鬧鐘使用的是絕對時間(RTC、RTC_WAKEUP、POWER_OFF_WAKEUP), 那么本屬性就得使用絕對時間,比如當(dāng)前時間就表示 為:System.currentTimeMillis()。
- intervalTime:表示兩次鬧鐘執(zhí)行的間隔時間,也是以毫秒為單位.
- PendingIntent:綁定了鬧鐘的執(zhí)行動作,比如發(fā)送一個廣播、給出提示等等。 PendingIntent是Intent的封裝類。需要注意的是,如果是通過啟動服務(wù)來實(shí)現(xiàn)鬧鐘提 示的話,PendingIntent對象的獲取就應(yīng)該采用Pending.getService (Context c,int i,Intent intent,int j)方法;如果是通過廣播來實(shí)現(xiàn)鬧鐘 提示的話,PendingIntent對象的獲取就應(yīng)該采用 PendingIntent.getBroadcast (Context c,int i,Intent intent,int j)方法;如果是采用Activity的方式來實(shí) 現(xiàn)鬧鐘提示的話,PendingIntent對象的獲取就應(yīng)該采用 PendingIntent.getActivity(Context c,int i,Intent intent,int j)方法。 如果這三種方法錯用了的話,雖然不會報(bào)錯,但是看不到鬧鐘提示效果。
4.使用示例:一個簡單的定時任務(wù)
要說的是,此例子只在Android 4.4以下的系統(tǒng)可行,5.0以上并不可行,后續(xù)如果有5.0 以上AlarmManager的解決方案,到時再補(bǔ)上!另外,這里用set方法可能有點(diǎn)不準(zhǔn),如果要 更精確的話可以使用setExtra()方法來設(shè)置AlarmManager!
運(yùn)行效果圖:
實(shí)現(xiàn)代碼:
首先一個簡單的布局文件:activity_main.xml,另外在res創(chuàng)建一個raw文件夾,把音頻文件丟進(jìn)去! 另外創(chuàng)建一個只有外層布局的activity_clock.xml作為鬧鐘響時Activity的布局!沒東西,就不貼了
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:id="@+id/LinearLayout1" android:layout_width="match_parent" android:layout_height="match_parent" android:orientation="vertical"> <Button android:id="@+id/btn_set" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="設(shè)置鬧鐘" /> <Button android:id="@+id/btn_cancel" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="關(guān)閉鬧鐘" android:visibility="gone" /></LinearLayout>
接著是MainActivity.java,也很簡單:
public class MainActivity extends AppCompatActivity implements View.OnClickListener{ private Button btn_set; private Button btn_cancel; private AlarmManager alarmManager; private PendingIntent pi; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); bindViews(); } private void bindViews() { btn_set = (Button) findViewById(R.id.btn_set); btn_cancel = (Button) findViewById(R.id.btn_cancel); alarmManager = (AlarmManager) getSystemService(ALARM_SERVICE); Intent intent = new Intent(MainActivity.this, ClockActivity.class); pi = PendingIntent.getActivity(MainActivity.this, 0, intent, 0); btn_set.setOnClickListener(this); btn_cancel.setOnClickListener(this); } @Override public void onClick(View v) { switch (v.getId()){ case R.id.btn_set: Calendar currentTime = Calendar.getInstance(); new TimePickerDialog(MainActivity.this, 0, new TimePickerDialog.OnTimeSetListener() { @Override public void onTimeSet(TimePicker view, int hourOfDay, int minute) { //設(shè)置當(dāng)前時間 Calendar c = Calendar.getInstance(); c.setTimeInMillis(System.currentTimeMillis()); // 根據(jù)用戶選擇的時間來設(shè)置Calendar對象 c.set(Calendar.HOUR, hourOfDay); c.set(Calendar.MINUTE, minute); // ②設(shè)置AlarmManager在Calendar對應(yīng)的時間啟動Activity alarmManager.set(AlarmManager.RTC_WAKEUP, c.getTimeInMillis(), pi); Log.e("HEHE",c.getTimeInMillis()+""); //這里的時間是一個unix時間戳 // 提示鬧鐘設(shè)置完畢: Toast.makeText(MainActivity.this, "鬧鐘設(shè)置完畢~"+ c.getTimeInMillis(), Toast.LENGTH_SHORT).show(); } }, currentTime.get(Calendar.HOUR_OF_DAY), currentTime .get(Calendar.MINUTE), false).show(); btn_cancel.setVisibility(View.VISIBLE); break; case R.id.btn_cancel: alarmManager.cancel(pi); btn_cancel.setVisibility(View.GONE); Toast.makeText(MainActivity.this, "鬧鐘已取消", Toast.LENGTH_SHORT) .show(); break; } } }
然后是鬧鈴頁面的ClockActivity.java:
/** * Created by Jay on 2015/10/25 0025. */ public class ClockActivity extends AppCompatActivity { private MediaPlayer mediaPlayer; @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_clock); mediaPlayer = mediaPlayer.create(this,R.raw.pig); mediaPlayer.start(); //創(chuàng)建一個鬧鐘提醒的對話框,點(diǎn)擊確定關(guān)閉鈴聲與頁面 new AlertDialog.Builder(ClockActivity.this).setTitle("鬧鐘").setMessage("小豬小豬快起床~") .setPositiveButton("關(guān)閉鬧鈴", new DialogInterface.OnClickListener() { @Override public void onClick(DialogInterface dialog, int which) { mediaPlayer.stop(); ClockActivity.this.finish(); } }).show(); } }
代碼非常簡單,核心流程如下:
- AlarmManager alarmManager = (AlarmManager) getSystemService(ALARM_SERVICE);獲得系統(tǒng)提供的AlarmManager服務(wù)的對象
- Intent設(shè)置要啟動的組件: Intent intent = new Intent(MainActivity.this, ClockActivity.class);
- PendingIntent對象設(shè)置動作,啟動的是Activity還是Service,又或者是廣播!PendingIntent pi = PendingIntent.getActivity(MainActivity.this, 0, intent, 0);
- 調(diào)用AlarmManager的set( )方法設(shè)置單次鬧鐘的鬧鐘類型,啟動時間以及PendingIntent對象!alarmManager.set(AlarmManager.RTC_WAKEUP,c.getTimeInMillis(), pi);
另外假如出現(xiàn)鬧鈴無效的話,你可以從這些方面入手:
系統(tǒng)版本或者手機(jī),5.0以上基本沒戲,小米,自行百度吧~ 2.ClockActivity有注冊沒? 3.假如你用的是alarmManager發(fā)送廣播,廣播再激活A(yù)ctivity的話,則需要為Intent設(shè)置一個flag: i.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
4.
這些地方?jīng)]寫錯吧~別把getActivity寫成了getService等哦~
另外,關(guān)于AlarmManager結(jié)合后來Service實(shí)現(xiàn)定時后臺任務(wù)的例子,可見:4.2.2 Service進(jìn)階
5.代碼示例下載:
本節(jié)小結(jié):
好的,本節(jié)跟大家講解了Android中的AlarmManager(鬧鐘服務(wù))的使用,除了可以像例子那樣定制 一個自己的鬧鐘,也可以結(jié)合Service,Thread來完成輪詢等,用法多多,還需各位自行探究,嗯 本節(jié)就到這里,謝謝~