Android设置闹钟提醒

最近在进行的备忘录项目需要用到定时提醒，用闹钟服务是再好不过了的选择，但是之前只是在看入门书籍的时候模模糊糊地抄了一遍代码，到现在早就忘得一干二净了，只好再次利用强大的搜索引擎重新学习一番。

设置时间

用户可以给需要提示的便签设置指定的时间。说到设置时间，就是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类里面有几个常量，定义了闹钟的唤醒方式

1. AlarmManager.ELAPSED_REALTIME： 采用的时间值一个相对值，以机器的开机时间为0时间点，假如到了设定的时间点但是机器是息屏状态时，闹钟服务无法执行。
2. AlarmManager.ELAPSED_REALTIME_WAKEUP：采用的时间值和ELAPSED_REALTIME相同，但是可以在息屏状态下唤醒机器。
3. AlarmManager.RTC：采用的时UTC时间，即与机器的开机时间无关。无法在息屏状态下运行服务。
4. 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参数控制服务运行的时间

最后

闹钟部分还有一些其他的功能和坑，如重复定时，用户重启机器等，因为暂时没有使用，暂不写在文中，以后踩了坑的话会来更新这篇文章。