初探AlarmManager:使用

Android闹钟服务

AlarmManager是Android系统提供的一种执行定时任务的手段,一般适用于长时间或者需要唤醒cpu保证准时的定时任务,提供唤醒和非唤醒, 重复和一次性等模式。系统源码中的闹钟app就是基于它。设备关闭或是重启的时候会被清除。

使用方式

  1. 获取AlarmManager实例
AlarmManager alarmManager = (AlarmManager) context.getSystemService(ALARM_SERVICE);
  1. 构造一个Intent
Intent intent = new Intent(context, targetClass.class);
//intetn.setAction(action)...
  1. 构造一个PendingIntent
PendingIntent PendingIntent = PendingIntent.getXXX(context, requestCode, intent, flag);

PendingIntent的getXXX方法名根据targetClass的类型替换, targetClass是除了content provider的其他组件。

大致解释一下PendingIntent。它是对Intent的进一步封装,能够完成更多的操作。它通过一系列getXXX得到,其中有两个参数比较重要:requestCode和flag。

RequestCode

有时Notification或AlarmManager会设置多个PendingIntent,PendingIntent通过requestCode区分不同,当通过它同时设置多个操作时需要注意设置不同的requestCode,否则后设置的会把先设置的覆盖掉。

Flag

FLAG_CANCEL_CURRENT:如果当前系统中已经存在一个相同的PendingIntent对象,那么就将先将已有的PendingIntent取消,然后重新生成一个PendingIntent对象。

FLAG_NO_CREATE:如果当前系统中不存在相同的PendingIntent对象,系统将不会创建该PendingIntent对象而是直接返回null。

FLAG_ONE_SHOT:该PendingIntent只作用一次。在该PendingIntent对象通过send()方法触发过后,PendingIntent将自动调用cancel()进行销毁,那么如果你再调用send()方法的话,系统将会返回一个SendIntentException。

FLAG_UPDATE_CURRENT:如果系统中有一个和你描述的PendingIntent对等的PendingInent,那么系统将使用该PendingIntent对象,但是会使用新的Intent来更新之前PendingIntent中的Intent对象数据,例如更新Intent中的Extras。

  1. 调用alarmManager的set方法
alarmManager.set(type, triggerAtMillis, pendingIntent);
alarmManager.setExact(type, triggerAtMillis, pendingIntent);
alarmManager.setWindow(type, startTime, lengthTime, pendingIntent);
alarmManager.setRepeating(type, triggerAtMillis, interval, pendingIntent);
alarmManager.setInExactRepeating(type, triggerAtMillis, interval, pendingIntent);
alarmManager.setAndAllowWhileIdle(type, triggerAtMillis, pendingIntent);
alarmManager.setExactAndAllowWhileIdle(type, triggerAtMillis, pendingIntent);
...

先解释一下type参数

Type

public static final int RTC_WAKEUP = 0;// 表示闹钟在睡眠状态下唤醒系统并执行提示功能,绝对时间。
public static final int RTC = 1;// 睡眠状态下不可用,绝对时间。
public static final int ELAPSED_REALTIME_WAKEUP = 2;// 睡眠状态下可用,相对时间。
public static final int ELAPSED_REALTIME = 3;// 睡眠状态下不可用,相对时间。
POWER_OFF_WAKEUP,即使在关机后还能提醒,但是Android4.0以后就没有了

不同闹钟类型对应的任务首次时间的获取方法:若为ELAPSED_REALTIME_WAKEUP,那么当前时间就为 SystemClock.elapsedRealtime();若为RTC_WAKEUP,那么当前时间就为System.currentTimeMillis()。

  1. 取消闹钟
alarmManager.cancel(PendingIntent operation);
alarmManager.cancel(AlarmManager.OnAlarmListener listener);
  1. 取得下一次闹钟
alarmManager.getNextAlarmClock();

Set方法

单次闹钟

1.set

set(type, triggerAtMillis, pendingIntent);
set(int type, long triggerAtMillis, String tag, AlarmManager.OnAlarmListener listener, Handler targetHandler)

第二个方法是第一个方法的变体,区别就是从触发pendingintent变成了触发listener回调,但和pendingintent一样,只能和一个alarm绑定。后面的handler决定了在哪个handler中执行回调,填null则在主线程回调。
2.setExact

setExact(type, triggerAtMillis, pendingIntent);
setExact(int type, long triggerAtMillis, String tag, AlarmManager.OnAlarmListener listener, Handler targetHandler)

3.setWindow

setWindow(type, startTime, lengthTime, pendingIntent);
setWindow(int type, long windowStartMillis, long windowLengthMillis, String tag, AlarmManager.OnAlarmListener listener, Handler targetHandler)

4.setAndAllowWhileIdle

setAndAllowWhileIdle(type, triggerAtMillis, pendingIntent);
setExactAndAllowWhileIdle(int type, long triggerAtMillis, PendingIntent operation)

5.setAlarmClock

setAlarmClock(AlarmClockInfo, pendingIntent);

set方法提供设置一次性的闹钟,但随着Android系统的完善,考虑到功耗等等因素,需要更加精细地控制闹钟。因此提供了一些其他情况下的set方法。看下官方文档的描述:

Note: Beginning with API 19 (Build.VERSION_CODES.KITKAT) alarm delivery is inexact: the OS will shift alarms in order to minimize wakeups and battery use. There are new APIs to support applications which need strict delivery guarantees; see setWindow(int, long, long, android.app.PendingIntent) and setExact(int, long, android.app.PendingIntent).

在Android api19之前,set方法是精准的,但在19之后,为了降低频繁唤醒cpu造成的电量浪费,系统会自动将几个alarm放在一起触发,set方法自然也就无法保证准确性。

因此Android又提供了setExact和setWindow来保证准确性。setExact保证精准触发,setWindow保证在设置的时间段内一定触发。
然而在Android api23开始,Android加入了低电耗模式和应用待机模式。其中低电耗模式明确指出在该模式下setExact和setWindow都会延迟执行。但Android也给出了解决办法:

标准 AlarmManager 闹钟(包括 setExact() 和 setWindow())推迟到下一个维护期。
如果您需要设置在设备处于低电耗模式时触发的闹钟,请使用 setAndAllowWhileIdle() 或 setExactAndAllowWhileIdle()。
使用 setAlarmClock() 设置的闹钟将继续正常触发,系统会在这些闹钟触发之前不久退出低电耗模式。

正如文档所述,setAndAllowWhileIdle和setExactAndAllowWhileIdle可以在低电耗下触发,或者使用setAlarmClock。
setAlarmClock和setAndAllowWhileIdle基本一致,都可以在低电耗模式下唤醒,持有mTriggerTime和mShowIntent(pendingIntent)两个成员变量,是对闹钟事件的一个封装,getNextAlarmClock返回的就是一个AlarmClockInfo。

重复闹钟

1.setRepeating

alarmManager.setRepeating(type, triggerAtMillis, interval, pendingIntent);

2.setInExactRepeating

alarmManager.setInExactRepeating(type, triggerAtMillis, interval, pendingIntent);

这两个方法可以重复执行设定的pendingIntent。区别同上。

注意事项

7.1系统PendingIntent包装的Intent不能直接设置Parcable对象,但可以放到bundle中。经查阅好像是6.0以上会出现,需要注意。

Further

https://www.jianshu.com/p/767412bf2af4
https://cloud.tencent.com/developer/article/1035539
https://www.cnblogs.com/leipDao/p/8203684.html

你可能感兴趣的:(初探AlarmManager:使用)