初探AlarmManager：使用

Posted 2023-04-15

参考技术A

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

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

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

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

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。

先解释一下type参数

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

1.set

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

3.setWindow

4.setAndAllowWhileIdle

5.setAlarmClock

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

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

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

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

1.setRepeating

2.setInExactRepeating

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

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

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

Android闹钟 AlarmManager的使用

AlarmManager介绍

　　AlarmManager这个类提供对系统闹钟服务的访问接口。

　　你可以为你的应用设定一个在未来某个时间唤醒的功能。

　　当闹钟响起，实际上是系统发出了为这个闹钟注册的广播，会自动开启目标应用。

　　注册的闹钟在设备睡眠的时候仍然会保留，可以选择性地设置是否唤醒设备，但是当设备关机和重启后，闹钟将会被清除。

 

　　在alarm的receiver的onReceive()方法被执行的时候，Alarm Manager持有一个CPU唤醒锁，这样就保证了设备在处理完广播之前不会sleep。

　　一旦onReceive()方法返回，Alarm Manager就会释放这个锁，表明一些情况下可能onReceive()方法一执行完设备就会sleep。

　　如果你的alarm receiver中调用了Context.startService()，那么很可能service还没起来设备就sleep了。

　　为了阻止这种情况，你的BroadcastReceiver和Service需要实现不同的唤醒锁机制，来确保设备持续运行到service可用为止。

 

　　注意：Alarm Manager主要是用来在特定时刻运行你的代码，即便是你的应用在那个特定时刻没有跑的情况。

　　对于常规的计时操作(ticks, timeouts, etc)，使用Handler处理更加方便和有效率。

 

　　另：从API 19开始，alarm的机制都是非准确传递，操作系统将会转换闹钟，来最小化唤醒和电池使用。

　　有一些新的API会支持严格准确的传递，见 setWindow(int, long, long, PendingIntent)和setExact(int, long, PendingIntent)。

　　targetSdkVersion在API 19之前应用仍将继续使用以前的行为，所有的闹钟在要求准确传递的情况下都会准确传递。

 

闹钟Demo

　　Android Api demos中就有关于闹钟使用的Demo：

　　com.example.android.apis.app.AlarmController

　　其中设定了两种闹钟，一种是一次性的，一种是重复的。

Manifest中的声明，process属性

　　自定义的receiver，在manifest中声明如下：

        <receiver
            android:name=".OneShotAlarm"
            android:process=":remote" />
        <receiver
            android:name=".RepeatingAlarm"
            android:process=":remote" />

 

　　Demo中两个Receiver的onReceive方法中显示了各自的Toast提示，所以不再列出。

　　在此讨论一下process属性，它规定了组件(activity, service, receiver等)所在的进程。

　　通常情况下，没有指定这个属性，一个应用所有的组件都运行在应用的默认进程中，进程的名字和应用的包名一致。

　　比如manifest的package="com.example.helloalarm"，则默认进程名就是com.example.helloalarm。

　　<application>元素的process属性可以为全部的组件设置一个不同的默认进程。

　　组件可以override这个默认的进程设置，这样你的应用就可以是多进程的。

 

　　如果你的process属性以一个冒号开头，进程名会在原来的进程名之后附加冒号之后的字符串作为新的进程名。当组件需要时，会自动创建这个进程。这个进程是应用私有的进程。

　　如果process属性以小写字母开头，将会直接以属性中的这个名字作为进程名，这是一个全局进程，这样的进程可以被多个不同应用中的组件共享。

 

一次性闹钟

            // When the alarm goes off, we want to broadcast an Intent to our
            // BroadcastReceiver. Here we make an Intent with an explicit class
            // name to have our own receiver (which has been published in
            // AndroidManifest.xml) instantiated and called, and then create an
            // IntentSender to have the intent executed as a broadcast.
            Intent intent = new Intent(AlarmController.this, OneShotAlarm.class);
            PendingIntent sender = PendingIntent.getBroadcast(
                    AlarmController.this, 0, intent, 0);

            // We want the alarm to go off 10 seconds from now.
            Calendar calendar = Calendar.getInstance();
            calendar.setTimeInMillis(System.currentTimeMillis());
            calendar.add(Calendar.SECOND, 10);

            // Schedule the alarm!
            AlarmManager am = (AlarmManager) getSystemService(ALARM_SERVICE);
            am.set(AlarmManager.RTC_WAKEUP, calendar.getTimeInMillis(), sender);

 

重复闹钟

　　闹钟设置：

            // When the alarm goes off, we want to broadcast an Intent to our
            // BroadcastReceiver. Here we make an Intent with an explicit class
            // name to have our own receiver (which has been published in
            // AndroidManifest.xml) instantiated and called, and then create an
            // IntentSender to have the intent executed as a broadcast.
            // Note that unlike above, this IntentSender is configured to
            // allow itself to be sent multiple times.
            Intent intent = new Intent(AlarmController.this,
                    RepeatingAlarm.class);
            PendingIntent sender = PendingIntent.getBroadcast(
                    AlarmController.this, 0, intent, 0);

            // We want the alarm to go off 10 seconds from now.
            Calendar calendar = Calendar.getInstance();
            calendar.setTimeInMillis(System.currentTimeMillis());
            calendar.add(Calendar.SECOND, 10);
            // Schedule the alarm!
            AlarmManager am = (AlarmManager) getSystemService(ALARM_SERVICE);
            am.setRepeating(AlarmManager.RTC_WAKEUP,
                    calendar.getTimeInMillis(), 10 * 1000, sender);

 

　　闹钟取消：

            // Create the same intent, and thus a matching IntentSender, for
            // the one that was scheduled.
            Intent intent = new Intent(AlarmController.this,
                    RepeatingAlarm.class);
            PendingIntent sender = PendingIntent.getBroadcast(
                    AlarmController.this, 0, intent, 0);

            // And cancel the alarm.
            AlarmManager am = (AlarmManager) getSystemService(ALARM_SERVICE);
            am.cancel(sender);

 

AlarmManager说明

　　AlarmManager这个类提供对系统闹钟服务的访问接口。

　　对它的获取是通过系统服务：

 　　Context.getSystemService(Context.ALARM_SERVICE)。

 

　　相关方法说明：

　　cancel(PendingIntent operation)方法将会取消Intent匹配的任何闹钟。

　　关于Intent的匹配，查看filterEquals(Intent other)方法的说明可知，两个Intent从intent resolution(filtering)(Intent决议或过滤)的角度来看是一致的，即认为两个Intent相等。即是说，Intent的action,data,type,class,categories是相同的，其他的数据都不在比较范围之内。

 

　　set(int type, long triggerAtMillis, PendingIntent operation)方法将会设置一个闹钟。

　　注意：对于计时操作，可能使用Handler更加有效率和简单。

　　设置闹钟的时候注意：

　　1.如果声明的triggerAtMillis是一个过去的时间，闹钟将会立即被触发。

　　2.如果已经有一个相同intent的闹钟被设置过了，那么前一个闹钟将会取消，被新设置的闹钟所代替。

 

　　注意这里说的intent相同指的都是Intent在 filterEquals(Intent)的定义下匹配。

　　闹钟是一个广播，接收器需要自己定义和注册，注册使用动态注册( registerReceiver(BroadcastReceiver, IntentFilter) )或者静态注册(<receiver> tag in an AndroidManifest.xml file)都可以。 

　　setRepeating(int type, long triggerAtMillis, long intervalMillis, PendingIntent operation)方法将会设置一个重复性的闹钟。

　　比set方法多了一个间隔参数。

 

　　type的类型是四种：

　　ELAPSED_REALTIME, ELAPSED_REALTIME_WAKEUP, RTC, RTC_WAKEUP.

　　区分的是时间标准和是否在睡眠状态下唤醒设备。

　　具体查看官方文档吧不再详细解释啦。

 

实例

　　比如要设置一个每晚21:30唤醒的重复闹钟：

    private static final int INTERVAL = 1000 * 60 * 60 * 24;// 24h

//...


        Intent intent = new Intent(context, RequestAlarmReceiver.class);
        PendingIntent sender = PendingIntent.getBroadcast(context,
                REQUEST_CODE, intent, PendingIntent.FLAG_CANCEL_CURRENT);

        // Schedule the alarm!
        AlarmManager am = (AlarmManager) context
                .getSystemService(Context.ALARM_SERVICE);

        Calendar calendar = Calendar.getInstance();
        calendar.set(Calendar.HOUR_OF_DAY, 21);
        calendar.set(Calendar.MINUTE, 30);
        calendar.set(Calendar.SECOND, 10);
        calendar.set(Calendar.MILLISECOND, 0);

        am.setRepeating(AlarmManager.RTC_WAKEUP, calendar.getTimeInMillis(),
                INTERVAL, sender);

 

 

参考资料

　　AlarmManager:

　　http://developer.android.com/reference/android/app/AlarmManager.html

 

　　闹钟Demo解析：

　　http://blog.csdn.net/mapdigit/article/details/7644134