一:AlarmManager简介
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”
注:以上段落来自于 http://blog.csdn.net/jeethongfei/article/details/6767826
二:代码实现
1.创建广播接收器
import android.content.BroadcastReceiver; import android.content.Context; import android.content.Intent; import android.widget.Toast; public class MyReceiver extends BroadcastReceiver{ @Override public void onReceive(Context context, Intent intent) { if(intent != null){ //接收到广播后,执行响铃操作 String info = intent.getStringExtra("tmac"); Toast.makeText(context, "广播接收成功"+":"+info, 1).show(); } } }
2.注册广播接收器
<!-- 在Application标签内添加receiver标签--> <receiver android:name="com.jms.testdemo.MyReceiver"> <intent-filter > <action android:name="itsdon"/> </intent-filter> </receiver>
3.功能代码
1 import java.util.Calendar; 2 import java.util.TimeZone; 3 import android.app.Activity; 4 import android.app.AlarmManager; 5 import android.app.PendingIntent; 6 import android.content.Context; 7 import android.content.Intent; 8 import android.os.Bundle; 9 import android.os.SystemClock; 10 import android.view.View; 11 import android.view.View.OnClickListener; 12 import android.widget.Button; 13 import android.widget.TimePicker; 14 import android.widget.TimePicker.OnTimeChangedListener; 15 import android.widget.Toast; 16 17 public class MainActivity extends Activity { 18 19 public static final String TAG = "HomeActivity"; 20 private TimePicker timePicker; 21 private Button setAlarm_btn; 22 private Button cancel_btn; 23 private int mHour = -1; //timePicker显示的小时 24 private int mMinute = -1; //timePicker显示的分钟 25 private AlarmManager aManager; 26 private PendingIntent pIntent; 27 28 @Override 29 protected void onCreate(Bundle savedInstanceState) { 30 super.onCreate(savedInstanceState); 31 setContentView(R.layout.activity_main); 32 initView(); 33 } 34 35 public void initView(){ 36 37 Calendar calendar = Calendar.getInstance(); 38 //设置当前位置的时区 39 calendar.setTimeZone(TimeZone.getTimeZone("GMT+8")); 40 if(mHour == -1 && mMinute == -1){ 41 mHour = calendar.get(Calendar.HOUR_OF_DAY); 42 mMinute = calendar.get(Calendar.MINUTE); 43 } 44 45 timePicker = (TimePicker) findViewById(R.id.timepicker); 46 timePicker.setCurrentHour(mHour); 47 timePicker.setCurrentMinute(mMinute); 48 timePicker.setOnTimeChangedListener(new OnTimeChangedListener() { 49 50 @Override 51 public void onTimeChanged(TimePicker tPicker, int hour, int minute) { 52 mHour = hour; 53 mMinute = minute; 54 } 55 }); 56 57 setAlarm_btn = (Button) findViewById(R.id.setAlarm); 58 aManager = (AlarmManager) getSystemService(Context.ALARM_SERVICE); 59 Intent intent = new Intent(); 60 intent.setAction("itsdon"); 61 intent.putExtra("tmac", "tracy mcgrady"); 62 pIntent = PendingIntent.getBroadcast(getApplicationContext(),0, intent, 0); 63 64 setAlarm_btn.setOnClickListener(new OnClickListener() { 65 66 @Override 67 public void onClick(View arg0) { 68 Calendar calendar = Calendar.getInstance(); 69 calendar.setTimeInMillis(System.currentTimeMillis()); 70 calendar.setTimeZone(TimeZone.getTimeZone("GMT+8")); 71 calendar.set(Calendar.MINUTE, mMinute); 72 calendar.set(Calendar.HOUR_OF_DAY, mHour); 73 calendar.set(Calendar.SECOND,0); 74 calendar.set(Calendar.MILLISECOND,0); 75 76 //选择的每天的定时的时间 77 long selectTime = calendar.getTimeInMillis(); 78 //当前的时间 79 long currentTime = System.currentTimeMillis(); 80 // 开机之后到现在的运行时间(包括睡眠时间) 81 long firstTime = SystemClock.elapsedRealtime(); 82 83 //如果当前时间大于选择的闹铃时间,那么从闹铃时间变为第二天的设定时间 84 if(currentTime > selectTime){ 85 Toast.makeText(getApplicationContext(), "当前时间大于设置的闹铃时间",Toast.LENGTH_LONG).show(); 86 calendar.add(Calendar.DAY_OF_MONTH, 1); 87 selectTime = calendar.getTimeInMillis(); 88 } 89 90 //计算当前时间到设定时间的时间差 91 long time = selectTime - currentTime; 92 firstTime += time; 93 aManager.setRepeating(AlarmManager.ELAPSED_REALTIME_WAKEUP,firstTime, 10*1000, pIntent); 94 95 Toast.makeText(getApplicationContext(), "闹钟设置成功",1).show(); 96 } 97 }); 98 99 cancel_btn = (Button) findViewById(R.id.cancel); 100 cancel_btn.setOnClickListener(new OnClickListener() { 101 102 @Override 103 public void onClick(View arg0) { 104 aManager.cancel(pIntent); 105 } 106 }); 107 } 108 }
4.效果图
5.说明
设置闹铃成功后,即使退出应用程序,仍然会发送广播和处理广播,除非“关闭闹铃"。详情见代码;
6.额外
package com.jsm.student;
public class Student{
}
Student s = new Student();
s.getClass().getName(); == com.jms.student.Student
s.getClass().getSimpleName(); == Student