Android闹钟服务AlarmManager

获取服务

AlarmManager mAlarmManager = (AlarmManager) getSystemService(Context.ALARM_SERVICE);

设置闹钟

Android4.4以上

方法声明:

public void setWindow(int type, long windowStartMillis, long windowLengthMillis, PendingIntent operation)

/*
int type:闹钟的类型,常用的有5个值:
AlarmManager.ELAPSED_REALTIME:表示闹钟在手机睡眠状态下不可用,该状态下闹钟使用相对时间(相对于系统启动开始),状态值为3;
AlarmManager.ELAPSED_REALTIME_WAKEUP:表示闹钟在睡眠状态下会唤醒系统并执行提示功能,该状态下闹钟也使用相对时间,状态值为2;
AlarmManager.RTC:表示闹钟在睡眠状态下不可用,该状态下闹钟使用绝对时间,即当前系统时间,状态值为1;
AlarmManager.RTC_WAKEUP:表示闹钟在睡眠状态下会唤醒系统并执行提示功能,该状态下闹钟使用绝对时间,状态值为0;
AlarmManager.POWER_OFF_WAKEUP:表示闹钟在手机关机状态下也能正常进行提示功能,所以是5个状态中用的最多的状态之一,该状态下闹钟也是用绝对时间,状态值为4;不过本状态好像受SDK版本影响,某些版本并不支持;

long windowStartMillis:
闹钟的开始时间

long windowLengthMillis:
闹钟窗口时长

PendingIntent operation:
需要执行的操作
*/

示例:

//设置一个10分钟后执行的闹钟,此方法只设置一次
mAlarmManager.setWindow(AlarmManager.RTC_WAKEUP,
                    System.currentTimeMillis() + 10 * minuteMills,
                    2 * minuteMills,
                    yourPendingIntent;

注意:如果设置的起始时间小于当前时间,闹钟将会马上被触发。如果触发的事件里面又设置了一次闹钟(相当于递归),就会进入死循环。

Android4.4以下:

方法声明:

//注册一个新的闹铃,一次性闹钟
set(int type, long triggerAtMillis, PendingIntent operation)

//注册一个新的闹铃,这个闹铃将在指定的时间被准确的执行
setExact(int type, long triggerAtMillis, PendingIntent operation)

//注册一个对触发时间并不是很精准的闹铃,也就是闹钟间隔时间不固定,例如,一个闹铃每小时都会重复,但不一定都是在每个小时的最开始被触发
//triggerAtMillis为闹钟首次执行时间,intervalMillis为闹钟两次执行的时间间隔
setInexactRepeating(int type, long triggerAtMillis, long intervalMillis, PendingIntent operation)

//注册一个重复类型的闹铃
setRepeating(int type, long triggerAtMillis, long intervalMillis, PendingIntent operation)

//设定系统时钟时间
setTime(long millis)

//设置系统默认时区
setTimeZone(String timeZone)

//得到下一个闹钟,返回值AlarmManager.AlarmClockInfo
getNextAlarmClock()

//和set方法类似,这个闹钟运行在系统处于低电模式时有效
setAndAllowWhileIdle(int type, long triggerAtMillis, PendingIntent operation) 

示例:

//设置单次闹钟
mAlarmManager.set(AlarmManager.RTC_WAKEUP, System.currentTimeMillis() + minuteMills, yourPendingIntent);

//设置重复闹钟
mAlarmManager.setInexactRepeating(AlarmManager.RTC_WAKEUP,
                    System.currentTimeMillis() + minuteMills,
                    10 * minuteMills,
                    yourPendingIntent);

取消闹钟

//取消参数匹配的闹铃
mAlarmManager.cancel(yourPendingIntent);

闹钟为系统级别的一种通知,可以不依赖于应用的存活为条件,因此也可以用于应用挂掉后定时重启应用等场景。

//定时重启
Intent intent = getPackageManager().getLaunchIntentForPackage(getPackageName());
PendingIntent restartIntent = PendingIntent.getActivity(getApplicationContext(), 0, intent, 0);
AlarmManager mgr = (AlarmManager) mContext.getSystemService(Context.ALARM_SERVICE);
mgr.set(AlarmManager.RTC, System.currentTimeMillis() + 500, restartIntent); // 定时重启应用
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章