最近在进行的备忘录项目需要用到定时提醒,用闹钟服务是再好不过了的选择,但是之前只是在看入门书籍的时候模模糊糊地抄了一遍代码,到现在早就忘得一干二净了,只好再次利用强大的搜索引擎重新学习一番。
设置时间
用户可以给需要提示的便签设置指定的时间。说到设置时间,就是TimePicker和DatePicker了,暂时不考虑这两个原生控件是否美观,实现功能优先(因为太菜)。可是这俩我也没怎么接触过,翻翻官方Guide把。
TimePicker
TimePicker是用来选择时间的,只有小时和分钟两个单位,在不同的API版本上有着不同的视觉效果,官方给的建议是自己建立一个类继承DialogFragment在onCreateDialog方法内返回一个TimePickerDialog。官方都这么说了,那就这么来把。
public class TimePickerDialogFragment extends DialogFragment implements TimePickerDialog.OnTimeSetListener {
@Override
public Dialog onCreateDialog(Bundle savedInstanceState) {
final Calendar c = Calendar.getInstance();
int hour = c.get(Calendar.HOUR_OF_DAY); // 选择器的初始小时值
int minute = c.get(Calendar.MINUTE); // 选择器的初始分钟值
return new TimePickerDialog(getActivity(), this, hour, minute, true); // 最后一个参数是选择是否使用24小时为单位,true为是
}
// 当对话框关闭后执行
@Override
public void onTimeSet(TimePicker timePicker, int i, int i1) {
// 进行时间设定
}
DatePicker
DatePicker与TimePicker类似,官网都是推荐通过DialogFragment来生成
public static class DatePickerFragment extends DialogFragment
implements DatePickerDialog.OnDateSetListener {
@Override
public Dialog onCreateDialog(Bundle savedInstanceState) {
// 设置DatePicker上的默认值
final Calendar c = Calendar.getInstance();
int year = c.get(Calendar.YEAR);
int month = c.get(Calendar.MONTH);
int day = c.get(Calendar.DAY_OF_MONTH);
// 生成DatePicker
return new DatePickerDialog(getActivity(), this, year, month, day);
}
public void onDateSet(DatePicker view, int year, int month, int day) {
// 进行日期设定
}
}
设置闹钟
既然时间设置好了,下面就是重头戏,通过用户设定的时间来设置闹钟。这个类不能直接new来实例化。
闹钟是系统的一种服务,通过AlarmManager这个类来管理。AlarmManager可以通过context.getSystem(ALARM_SERVICE)
来获取。AlarmManager使用的场景如下:你需要让你的程序代码能够在某一个特定时刻被执行,而不考虑程序目前的是否在运行。如果想要实现通常的定时操作,使用Handler会更简单。
从API 19(KITKAT)开始,闹钟唤醒的时间是不准确的:系统为了减少唤醒和电量使用会对闹钟时间进行一定的偏移。提供了新的APIs来支持那些需要准时唤醒的应用,可以参考
setWidndow(int, long, long, PendingIntent)
和setExtact(int, long, PendingIntent)
,API版本低于19的应用还可以使用之前的API且那些API保证唤醒是准时的
闹钟的唤醒方式
在AlarmManager类里面有几个常量,定义了闹钟的唤醒方式
- AlarmManager.ELAPSED_REALTIME: 采用的时间值一个相对值,以机器的开机时间为0时间点,假如到了设定的时间点但是机器是息屏状态时,闹钟服务无法执行。
- AlarmManager.ELAPSED_REALTIME_WAKEUP:采用的时间值和ELAPSED_REALTIME相同,但是可以在息屏状态下唤醒机器。
- AlarmManager.RTC:采用的时UTC时间,即与机器的开机时间无关。无法在息屏状态下运行服务。
- AlarmManager.RTC_WAKEUP:在RTC的前提下增加了息屏唤醒的功能。
常用的方法
在API小于19的机器上,我们可以使用set(int type, long triggerAtMills, PendingIntent operation)
方法就可以设定一个闹钟了,参数名字很好理解,type就是上面提到的闹钟的唤醒方式,通常使用RTC_WAKEUP
,triggerAtMills参数我们需要从TimePicker中获取,可以在onTimeSet
接口中将用户设定的时间值保存在一个Calendar对象中,之后通过getTimeInMills
获取时间赋值给triggerAtMills就行了。operation参数我理解为执行闹钟服务时需要唤醒的东西,可以是一个Activity,也可以是Service或Broadcast。比如我要在闹钟执行时唤醒ClockActivity这个Activity,只需要写类似下面的代码就可以生成一个operation
Intent clock = new Intent(this, ClockActivity.class);
PendingIntent pendingIntent = PendingIntent.getActivity(this, 1, intent, PendingIntent.FLAG_UPDATE_CURRENT);
在API大于19的机器上,如果要执行闹钟服务准时,需要的方法是setExact(int type, long triggerAtMills, PendingIntent operation
,这个方法的参数和set方法一样,就不再重复了。还一个方法是setWindow(int type, long windowStartMills, long windowLengthMills, PendingIntent operation)
,其中windowStartMills和triggerAtMills是一个东西,这个方法的一个特点在于能通过windowLengthMills参数控制服务运行的时间
最后
闹钟部分还有一些其他的功能和坑,如重复定时,用户重启机器等,因为暂时没有使用,暂不写在文中,以后踩了坑的话会来更新这篇文章。